Executando consultas SQL com o DB Query Client

Para executar consultas SQL com o DB Query Client, conclua as etapas a seguir:

1. Inicie o DB Query Client usando a seguinte URL:

   https://<hostname:port>/smcfs/yfshttpdbi/sterlingdbqueryclient.jsp

2. Insira o ID do Usuário e Senha. A autenticação do usuário é válida até a sessão atual expirar ou até a sessão atual ser encerrada. Se a sessão do navegador atual expirar, será possível inserir suas credenciais de login e executar consultas na mesma página.
3. Digite uma consulta SQL em Inserir consulta SQLe clique em Executar consulta.

   No campo Número de Linhas , especifique o número de linhas a serem exibidas por página Por padrão, o valor é configurado como 100 Se você inserir um valor maior, a paginação será ativada automaticamente É possível especificar um valor máximo de 10.000 linhas a serem exibidas por página.

   • Ordene o resultado da consulta por coluna sempre que DISTINCT for usado com a cláusula SELECT
   • DISTINCT permite executar a consulta a seguir:
     select distinct <organization_code> from yfs_item where 1=1;
     Nota: para a consulta DISTINCT com coluna de chave primária não selecionada, a paginação não é suportada. Por padrão, o valor é configurado como 100 Entretanto, se desejar visualizar mais registros, aumente o tamanho da página. No máximo 10.000 registros podem ser exibidos.
   • As consultas que contêm funções de agregação como cláusulas UNION, INTERSECTou WITH não são suportadas pela paginação. Essas consultas são executadas em um modo não paginado No entanto, se desejar visualizar mais registros, aumente o tamanho da página para um limite máximo de 10.000 registros.

   Nota:

   • Não é possível consultar tabelas que contenham dados sensíveis ou irrelevantes ou que não contenham dados de negócios
   • Não é possível executar consultas que modificam as tabelas
   Algumas consultas de amostra são as seguintes:

   
   select * from yfs_resource fetch first 10 rows only;
   select * from yfs_resource_permission fetch first 10 rows only;
   select * from yfs_user fetch first 10 rows only;

   • Tabelas de consultas para ordenar o resultado por coluna não primária. Por exemplo,

     select * from yfs_user order by loginid fetch first 10 rows only;

   • Criar associações usando subconsultas. Por exemplo,

     
     select u.user_key, ug.USERGROUP_KEY, u.loginid, ug. USERGROUP_NAME from (SELECT * FROM
     omdb.YFS_USER)  as u RIGHT OUTER JOIN (SELECT * FROM omdb.YFS_USER_GROUP) as ug ON
     u.USERGROUP_KEY = ug.USERGROUP_KEY fetch first 10 rows only;

   • Usando consulta de alias de coluna. Por exemplo, select order_no as Docket from yfs_order_header;

   • Recuperar informações de índice de tabelas usando instruções describe . Por exemplo, describe table YFS_USER;.. Esta consulta retorna apenas os detalhes básicos do esquema de tabela, como tipo de dados, nulo ou não nulo e não as informações de índice.. Entretanto, é possível executar describe indexes for table YFS_USER para recuperar os detalhes do índice da tabela.

   • Tabelas de consulta do esquema SYSCAT. É possível consultar as tabelas a seguir a partir do esquema SYSCAT:
     • ESQUEMATA
     • TABLES-Ao consultar esta tabela, é recomendado incluir uma cláusula WHERE com tabschema = 'OMDB'
     • VISUALIZAÇÕES-Ao consultar esta tabela, é recomendado incluir uma cláusula WHERE com viewschema = 'OMDB'
     • COLUMNS-Ao consultar esta tabela, recomenda-se incluir uma cláusula WHERE com tabschema = 'OMDB'
     • INDEXES-Ao consultar esta tabela, é recomendado incluir uma cláusula WHERE com tabschema = 'OMDB'
     • TABCONST-Ao consultar essa tabela, recomenda-se incluir uma cláusula WHERE com tabschema = 'OMDB'

     Por padrão, no modo não paginado, apenas os primeiros 100 registros são exibidos Se desejar exibir mais registros, no DB Query Client, especifique o número total de registros a serem exibidos.

   Métodos alternativos para executar consultas

   • Clique em Última execução de consultas para visualizar todas as consultas executadas anteriormente. As últimas 100 consultas anteriormente executadas são salvas, e 10 consultas são exibidas por página. É possível executar uma consulta na lista.
   • No campo Procurar consultas , insira termos apropriados, como palavras-chave de consulta ou nomes de tabelas para localizar sua consulta e clique em Executar consulta. Por exemplo, os termos de procura podem ser YFS_USER, SELECT Como alternativa, é possível rolar a lista e clicar em Avançar ou Anterior para localizar sua consulta..
   • Importar e executar uma consulta
   Nota:

   • Se você não terminar uma consulta com um ponto e vírgula, ela será anexada internamente.
   • Por padrão, a paginação é ativada Se ocorrer um problema para determinadas consultas, a paginação será desativada automaticamente, e o resultado da consulta será exibido com base no número de linhas inseridas
   • Se houver problemas momentâneos de conectividade do banco de dados, a ferramenta tentará novamente três vezes para se conectar ao banco de dados. Se não for bem-sucedido, uma mensagem apropriada será exibida
   • O tempo limite de consulta é 2 minutos.
   Resultados:

   • Para assegurar o desempenho ideal no ambiente de produção, apenas as primeiras 100 linhas são exibidas para consultas com as colunas CLOB
   • Para consultas SQL com colunas CLOB, no máximo 100 registros são exibidos e podem ser exportados.
   • As colunas BLOB são mostradas na saída como --BLOB Data-- em vez de mostrar um valor de sequência do objeto binário na página de resultado.
   • A ferramenta retorna os códigos de erro SQL exatos para que os usuários possam entender o que está errado com uma consulta. Por exemplo, ao executar select * from YFS_USER_DETAILS, a ferramenta retorna a mensagem de erro a seguir:

     Exceção ao executar consulta. Verifique a sintaxe da consulta / logs do servidor.
     "OMDB.YFS_USER_DETAILS" é um nome indefinido .. SQLCODE=-204, SQLSTATE=42704, DRIVER=3.69.49

4. Opcional: por padrão, a caixa de seleção Exportação de números como texto (Somente para visualização no Microsoft Excel) é marcada.. Para exportar seu resultado da consulta para o arquivo CSV, desmarque a caixa de seleção e, em seguida, clique em Exportar Os resultados da consulta são exportados para um .csv Por exemplo, queryResult--2020-8-5-13-19-19.csv.

   No arquivo CSV, números longos são exibidos no formato exponencial. Por exemplo, 12345678901234567890 é representado como 1.23457E+19..

   Para exportar os resultados da consulta para um arquivo CSV somente leitura , marque a caixa de seleção Exporte números como texto (Somente para visualização no Microsoft Excel) . Por exemplo, queryResult--2020-8-5-13-19-19_view-only-on-ms-excel.csv..

   O arquivo CSV pode ser aberto apenas no Microsoft Excel.. No arquivo CSV exportado, um apóstrofo (') é prefixado para números que são maiores que 11 dígitos para que os números inteiros sejam exibidos como texto no Microsoft Excel. No entanto, os números com menos de 11 dígitos são exibidos como inteiros e não contêm apóstrofo. Para números que contêm zeros iniciais, o Microsoft Excel trunca os zeros e exibe apenas números. Por exemplo, "0001" é exibido como "1".