Opções de IU em Suplementos de Planilha

Suplementos de Planilha fornecem elementos de interface de usuário comuns em vários recursos e controles adicionais específicos para painéis individuais.

Informações de Conexão

A seção superior da maioria dos painéis do add-in exibe informações sobre a conexão ativa, incluindo o URL do Banco de Dados, o esquema, o status da conexão e o tempo de sessão restante antes da expiração da conexão. Para conexões do OCI IAM, ele também exibe o usuário conectado.

Observação:

Embora o suplemento mantenha uma conexão ativa com o banco de dados, os dados recuperados são locais na planilha. Em caso de inatividade ou tempo limite de conexão, o suplemento exibe uma notificação e sugere que você se reconecte ao banco de dados.

Usando o Editor de Consulta SQL

O editor de consulta SQL é a área em que você grava, edita e exibe instruções SQL antes de executá-las.

Você pode inserir uma consulta manualmente ou selecionar tabelas, views e colunas no browser de objetos para ajudar a criar a instrução SQL. O editor de consulta SQL exibe números de linha e realce de sintaxe para as consultas.

As ações disponíveis no editor de consulta dependem do recurso de suplemento que você está usando. Em geral, você pode usar as seguintes opções com o editor de consulta SQL:

• Executar

  O primeiro botão, exibido como um círculo com um triângulo, é o botão Run. Clique neste botão para executar a instrução SQL e exibir os resultados da consulta na planilha selecionada.

• Limpar Conteúdo SQL

  O ícone de borracha ao lado de Executar remove a instrução SQL atual do editor de consulta.

• Recuperar consulta na planilha

  Este botão recupera a consulta SQL da planilha ativa e a exibe no editor de consulta SQL. Em seguida, você pode editar e executar a consulta novamente.

• Compartilhar como Hiperlink de Tabela

  Essa opção só está disponível para resultados de consulta gerados usando SQL Direto e Análise de Dados. Crie um Hyperlink de Tabela e compartilhe-o com outros usuários para que eles possam carregar os resultados da consulta somente leitura em uma planilha.

Observação:

Add-in para Excel fornece um menu flutuante com opções adicionais, como recarregar a janela do add-in. Clique na seta pequena no lado direito da janela do add-in para abrir o menu flutuante.

Selecione uma Planilha para Resultados da Consulta

Você pode usar a planilha padrão ou selecionar outra para exibir os resultados.

Observação:

Se você executar outra consulta na mesma planilha, o suplemento atualizará a planilha com o resultado da nova consulta.

Para usar outra planilha para uma consulta diferente, siga uma destas opções:

• Em Suplementos de Planilha, clique no botão de mais (+), especifique um nome em Adicionar nova planilha e clique no botão de marcação. O suplemento insere a nova planilha quando você executa a consulta. O botão de seta para a esquerda é cancelar e voltar.

• Insira uma nova planilha usando as opções no Excel ou no Google Sheets.

Em seguida, você pode selecionar a nova planilha em Selecionar planilha e exibir os resultados.

Informações da Consulta

Juntamente com os resultados da consulta, a planilha também exibe as seguintes informações de consulta:

• o URL do banco de dados

• o usuário ou o esquema do banco de dados que cria e executa a consulta

• a Consulta SQL real

• a configuração de atualização

• a data e a hora da consulta

Usar Variáveis de Bind em Consultas SQL

Você pode usar variáveis de bind em uma consulta SQL para fornecer valores em tempo de execução. Defina uma variável de bind na instrução SQL usando dois-pontos (:) seguido de um nome de variável.

Por exemplo

SELECT *
FROM employees
WHERE city = :ct;

Quando você executa a consulta, o suplemento solicita que você informe um valor para a variável de bind, :ct. Depois que você fornecer um valor, por exemplo, Austin, a consulta será executada usando esse valor. As informações de consulta exibidas com os resultados incluem a atribuição de variável de bind, por exemplo, :ct=Austin.

Você pode incluir várias variáveis de vínculo em uma consulta. O add-in retém valores usados recentemente para cada variável de bind. Ao executar a consulta novamente, você pode selecionar um valor recente ou inserir um novo valor. Você também pode limpar valores salvos anteriormente da caixa de diálogo Parâmetros de Consulta.

Atualizar Resultados da Consulta

Você pode usar Atualizar Consulta para reexecutar uma consulta salva e atualizar os resultados em uma planilha sem abrir os painéis SQL Direto, Análise de Dados ou Linguagem Natural.

Para atualizar os resultados da consulta:

1. Selecione uma planilha que contenha resultados de consulta gerados por Suplementos de Planilha.

2. Clique em Atualizar Consulta.

   O add-in executa novamente a consulta salva e atualiza a planilha atual com os resultados mais recentes.

Se a pasta de trabalho contiver planilhas adicionais com resultados de consulta atualizáveis, o suplemento exibirá o número de planilhas restantes e solicitará que você as atualize. Após a conclusão da atualização, o suplemento exibe um relatório que indica as planilhas que foram atualizadas com êxito e identifica as planilhas que não puderam ser atualizadas.

Observação:

Uma planilha poderá ser atualizada se a conexão do banco de dados correspondente for salva e conectada. Suplementos de Planilha atualiza cada planilha usando suas informações de conexão salvas, mesmo que essa conexão não seja a conexão ativa.

Uma operação de atualização pode falhar nos seguintes cenários:

• A visualização salva não corresponde mais às colunas retornadas pela consulta.

• Nenhuma conexão salva corresponde ao URL do banco de dados e ao usuário associado à planilha.

• A conexão de banco de dados necessária está desconectada.

O relatório de atualização fornece detalhes de planilhas com falha. Dependendo da causa, você pode atualizar a consulta ou visualização, adicionar ou importar uma conexão salva correspondente ou reconectar a conexão de banco de dados necessária antes de atualizar novamente.

Lidando com Dados Grandes

Para consultas com grandes conjuntos de dados, por exemplo, um resultado que contenha mais de 10.000 registros, o suplemento exibirá uma janela para confirmação se você quiser exibir o resultado inteiro.

Observação:

Ao trabalhar com tabelas dinâmicas, carregue os dados completos para obter resultados precisos da agregação.