Salvar, Compartilhar e Exportar Consultas SQL

Você pode salvar uma consulta SQL a qualquer momento e continuar trabalhando nela posteriormente. Você também pode salvar uma consulta concluída e compartilhar a consulta como um widget de pesquisa para uso futuro por você ou outros usuários.

Se você criou o widget com base em um intervalo de tempo fixo, toda vez que abrir o widget, ele mostrará os resultados do intervalo de tempo especificado na pesquisa. Por padrão, se você tiver criado o widget para um intervalo de tempo relativo (digamos os últimos 7 dias), toda vez que abrir o widget, ele mostrará os resultados atualizados de acordo com o seletor de tempo (Últimos 7 dias). Quando o widget é referenciado em um painel de controle, ele reflete a configuração do seletor de tempo da página.

Pré-requisitos:

O menu Ação do SQL Explorer permite que você salve e compartilhe suas pesquisas SQL com outras pessoas.

Salvar uma Pesquisa Concluída e Adicioná-la a um Painel de Controle

Para salvar uma consulta SQL e adicioná-la a um painel de controle:

  1. No menu Ações, selecione Salvar. A caixa de diálogo Salvar Pesquisa é exibida.
  2. Selecione um compartimento no qual a pesquisa será salva.
    Observação

    Não há associação entre o compartimento selecionado da pesquisa salva e os dados subjacentes que estão sendo consultados.
  3. Informe um Nome e uma Descrição para o widget.

    Opcionalmente, você pode salvar o widget de pesquisa e adicioná-lo a um painel de controle.

  4. Clique na opção Adicionar ao painel de controle.
  5. Escolha se deseja adicionar o widget a um painel de controle existente (selecione Compartimento do Painel de Controle e Painel de Controle específico) ou crie um novo painel de controle e forneça as informações necessárias.
    Observação

    O Ops Insights fornece os seguintes painéis prontos para uso do Exadata:
    • Painel de Controle da Célula do Exadata - Por Hora

      Painel de granularidade por hora para métricas de disco de célula.

    • Painel de Controle do Exadata IORM - Por Hora

      Painel de controle de granularidade por hora para métricas relacionadas ao Exadata IORM.

  6. Clique em Salvar.

Abrir uma Pesquisa Salva ou Predefinida Anteriormente

  1. No menu Ações, selecione Abrir. A caixa de diálogo Abrir Pesquisa é exibida.
  2. Escolha uma pesquisa salva anteriormente ou um dos widgets de pesquisa predefinidos que vem com o SQL Explorer.
  3. Clique em Abrir.

Excluir uma Pesquisa Salva

  1. No menu Ações, selecione Excluir. A caixa de diálogo Excluir Pesquisa é exibida.
  2. Escolha uma pesquisa salva anteriormente.
  3. Clique em Excluir.

Importante: Se você excluir um widget de pesquisa salva que atualmente é referenciado por um painel de controle existente, lembre-se de que ele não é excluído automaticamente do painel de controle. Isso resultará em um erro ao acessar o painel.

Observação

Não é possível excluir uma pesquisa predefinida pronta para uso.

Criar uma Consulta de Pesquisa Salva Usando uma Existente

Você pode criar uma pesquisa personalizada com base em uma existente usando a opção Salvar Como.

  1. No menuAções, selecioneAbrir. A caixa de diálogo Abrir Pesquisa é exibida.
  2. Escolha uma pesquisa salva ou predefinida anteriormente na lista.
  3. Clique em Abrir. Os critérios de pesquisa são exibidos no SQL Explorer.
  4. Atualize os critérios de pesquisa conforme necessário.
  5. Selecione Salvar Como no menu Ações.
  6. Informe um novo nome para a pesquisa atualizada.
  7. Clique em Salvar.

Atualizar o Nome e a Descrição de uma Pesquisa Existente

Ao desenvolver uma consulta SQL, talvez você queira alterar o nome e as informações descritivas associadas do widget de pesquisa. Você pode usar a opção Editar para fazer essas alterações.

  1. No menu Ações, selecione Abrir se estiver atualizando um widget de pesquisa existente. A caixa de diálogo Abrir Pesquisa é exibida.
  2. Selecione um compartimento no qual o widget de pesquisa reside.
    Observação

    Não há associação entre o compartimento selecionado da pesquisa salva e os dados subjacentes que estão sendo consultados.
  3. Selecione um widget de pesquisa e clique em Abrir para exibir a pesquisa no SQL Explorer.
  4. No menu Ações, selecione Editar. A caixa de diálogo Editar Pesquisa é exibida.
  5. Informe um Nome da Nova Pesquisa e/ou uma Descrição da Nova Pesquisa.
  6. Clique em Editar para salvar as alterações.

Criar Nova Pesquisa

Para limpar os critérios de pesquisa existentes e iniciar uma nova pesquisa, selecione Criar Novo no menu Ações.

Exportar Dados

Para exportar os dados obtidos de uma pesquisa, clique em Exportar para CSV no menu Pesquisa Salva. A exportação de dados tem limitação de que somente 10.000 linhas no máximo podem ser extraídas para uma única consulta (usando limit=1000 e pages=10). Como alternativa, você pode exportar dados via CLI (interface de linha de comando). A exportação via CLI é bastante avançada e fácil de usar. Veja a amostra abaixo sobre como obter dados usando a CLI:
  • Amostra usando um arquivo JSON:
    oci opsi
    opsi-data-objects query-data-templatized-query 
    --from-json file://./<file name>
    --compartment-id <compartment id>
    --limit 1000
    Onde o arquivo JSON contém o seguinte:
    {
       "dataObjectIdentifier":"opsidataobject.dbinsights.f0819908-5ae3-4cb5-8a81-80a4ba888881",
       "query":{
          "queryType":"TEMPLATIZED_QUERY",
          "selectList":[
             "DB_DISPLAY_NAME, CDB_NAME, EXADATA_DISPLAY_NAME, VMCLUSTER_NAME, CPU_UTILIZATION, ROLLUP_TIME_UTC"
          ],
          "whereConditionsList":[
              
          ],
          "groupByList":[
              
          ],
          "havingConditionsList":[
              
          ],
          "orderByList":[
             "ROLLUP_TIME_UTC ASC"
          ],
          "timeFilters":{
             "timeStart":"2024-01-05T00:00:00.000Z",
             "timeEnd":"2024-01-12T00:00:00.000Z"
          }
       },
       "resourceFilters":{
          "compartmentIdInSubtree":false
       }
    }
  • Exemplo de chamada da consulta diretamente no comando da CLI:
    oci opsi
    opsi-data-objects query-data-templatized-query 
    --compartment-id <compartment id>
    --data-object-identifier <data object id>
    --query-select-list '["DB_DISPLAY_NAME, CDB_NAME,EXADATA_DISPLAY_NAME, VMCLUSTER_NAME, CPU_UTILIZATION, ROLLUP_TIME_UTC"]'
    --query-order-by-list '["ROLLUP_TIME_UTC ASC"]'
    --limit 1000