Hologres:Parâmetros GUC

O Hologres oferece suporte a parâmetros Grand Unified Configuration (GUC) para controlar o comportamento de consultas, o gerenciamento de conexões, o desempenho e a segurança no nível da sessão ou do banco de dados.

select query_id, status, duration, query_start, application_name, command_tag
from hologres.hg_query_log
where query_id = '<QUERY_ID>';

Instruções

1. Leia o conteúdo em inglês para compreender O QUE precisa ser comunicado

2. Escreva o texto em português do Brasil DO ZERO — esqueça a estrutura das frases em inglês

3. Preserve toda a formatação markdown, blocos de código, links e imagens exatamente como estão

4. Copie os placeholders xref ({XREF_N}) literalmente, sem traduzir ou modificar

5. Aplique todas as regras específicas do idioma com rigor

6. Siga as regras de stopwords com tolerância zero

7. Use o modo imperativo em passos numerados e listas de procedimentos

8. Garanta a consistência terminológica — o mesmo termo deve ter a mesma tradução em todo o documento

9. Varie os inícios de frase em listas e tabelas — nenhum início deve se repetir mais de 3 vezes

10. Retorne APENAS o documento markdown em português do Brasil, sem explicações

    Verificar o valor atual de um parâmetro GUC

    Execute SHOW para consultar o valor atual ou padrão de um parâmetro:

    select query_id, status, duration, query_start, application_name, command_tag
    from hologres.hg_query_log
    where query_id = '<QUERY_ID>';

Instruções

1. Leia o conteúdo em inglês para compreender O QUE precisa ser comunicado

2. Escreva o texto em português do Brasil DO ZERO — esqueça a estrutura das frases em inglês

3. Preserve toda a formatação markdown, blocos de código, links e imagens exatamente como estão

4. Copie os placeholders xref ({XREF_N}) literalmente, sem traduzir ou modificar

5. Aplique todas as regras específicas do idioma com rigor

6. Siga as regras de stopwords com tolerância zero

7. Utilize o modo imperativo em passos numerados e listas de procedimentos

8. Garanta a consistência terminológica — o mesmo termo deve ter a mesma tradução em todo o documento

9. Varie os inícios de frase em listas e tabelas — nenhum início deve se repetir mais de 3 vezes

10. Retorne APENAS o documento markdown em português do Brasil, sem explicações

    Configurar parâmetros GUC

    Configure os parâmetros GUC no nível de sessão ou no nível de banco de dados, conforme o escopo do parâmetro e o seu caso de uso. Nem todos os parâmetros precisam ser definidos no nível de banco de dados.

    Nível de sessão

    A instrução SET configura um parâmetro apenas para a conexão atual. A configuração é descartada quando a conexão é encerrada. Utilize a configuração no nível de sessão quando o comportamento desejar aplicar a uma consulta ou carga de trabalho específica, e não globalmente.

    Sintaxe:

    select query_id, status, duration, query_start, application_name, command_tag
    from hologres.hg_query_log
    where query_id = '<QUERY_ID>';

    Exemplos:

    select query_id, status, duration, query_start, application_name, command_tag
    from hologres.hg_query_log
    where query_id = '<QUERY_ID>';

    Instruções

    1. Leia o conteúdo em inglês para compreender O QUE precisa ser comunicado

    2. Escreva o texto em português do Brasil DO ZERO — esqueça a estrutura das frases em inglês

    3. Preserve toda a formatação markdown, blocos de código, links e imagens exatamente como estão

    4. Copie os placeholders de xref ({XREF_N}) literalmente, sem traduzir ou modificar

    5. Aplique todas as regras específicas do idioma com rigor

    6. Siga as regras de stopwords com tolerância zero

    7. Utilize o modo imperativo em etapas numeradas e listas de procedimentos

    8. Garanta a consistência terminológica — o mesmo termo deve ter a mesma tradução em todo o documento

    9. Varie os inícios de frase em listas e tabelas — nenhum início deve se repetir mais de 3 vezes

    10. Retorne APENAS o documento markdown em português do Brasil, sem explicações adicionais

        Nível do banco de dados

        A instrução ALTER DATABASE define um parâmetro no nível do banco de dados. A alteração se aplica a todo o banco de dados sem exigir reinicialização da instância. É necessário fechar e reabrir sua conexão atual para que o novo valor entre em vigor; as conexões abertas posteriormente herdam o parâmetro automaticamente. Ao criar um novo banco de dados, configure explicitamente seus parâmetros GUC, pois eles não são herdados de forma automática.

        Sintaxe:

        select query_id, status, duration, query_start, application_name, command_tag
        from hologres.hg_query_log
        where query_id = '<QUERY_ID>';

        Exemplos:

        select query_id, status, duration, query_start, application_name, command_tag
        from hologres.hg_query_log
        where query_id = '<QUERY_ID>';

    Instruções

    1. Leia o conteúdo em inglês para compreender O QUE precisa ser comunicado

    2. Escreva o texto em português do Brasil DO ZERO — esqueça a estrutura das frases em inglês

    3. Preserve toda a formatação markdown, blocos de código, links e imagens exatamente como estão

    4. Copie os placeholders de xref ({XREF_N}) literalmente, sem traduzir ou modificar

    5. Aplique todas as regras específicas do idioma com rigor

    6. Siga as regras de stopwords com tolerância zero

    7. Utilize o modo imperativo em passos numerados e listas de procedimentos

    8. Garanta a consistência terminológica — o mesmo termo deve ter a mesma tradução em todo o documento

    9. Varie os inícios de frase em listas e tabelas — nenhum início deve se repetir mais de 3 vezes

    10. Retorne APENAS o documento markdown em português do Brasil, sem explicações

Instruções

1. Leia o conteúdo em inglês para compreender O QUE precisa ser comunicado

2. Escreva o texto em português do Brasil DO ZERO — esqueça a estrutura das frases em inglês

3. Preserve toda a formatação markdown, blocos de código, links e imagens exatamente como estão

4. Copie os placeholders de xref ({XREF_N}) literalmente, sem traduzir ou modificar

5. Aplique todas as regras específicas do idioma com rigor

6. Siga as regras de stopwords com tolerância zero

7. Utilize o modo imperativo em passos numerados e listas de procedimentos

8. Garanta a consistência terminológica — o mesmo termo deve ter a mesma tradução em todo o documento

9. Varie os inícios de frase em listas e tabelas — nenhum início deve se repetir mais de 3 vezes

10. Retorne APENAS o documento markdown em português do Brasil, sem explicações adicionais

    Obter o query ID

    O query ID identifica exclusivamente cada consulta no Hologres e compõe a chave primária do log de consultas lentas hologres.hg_query_log. Com o query ID de uma instrução, você consulta a duração, o status, o número de linhas lidas e outros detalhes de execução. Por isso, o query ID é o principal ponto de partida para troubleshooting.

    Por padrão, o Hologres não retorna o query ID ao cliente. Após ativar hg_experimental_display_query_id, o servidor retorna o query ID em uma mensagem NOTICE quando a instrução é executada.

    Descrição do parâmetro

    Item	Descrição
    Parâmetro	hg_experimental_display_query_id
    Efeito	Exibe o query ID no cliente em uma mensagem NOTICE durante a execução da instrução.
    Valor padrão	off
    Valores válidos	on ou off.
    Nível	Sessão ou banco de dados.
    Formato de retorno	Mensagem NOTICE no formato QueryID: <QUERY_ID>, por exemplo QueryID: 1002002606817130830.

    Considere os dois mecanismos a seguir:

    • O query ID chega em uma mensagem NOTICE, não como uma coluna no conjunto de resultados. Ler apenas os resultados da consulta (por exemplo, com fetchall()) não fornece o query ID. Use o mecanismo de NOTICE fornecido pelo seu driver.

    • Esse parâmetro se aplica a uma única sessão e é descartado quando a conexão fecha. Portanto, defina-o novamente em cada nova conexão. Isso é especialmente importante em pools de conexões, onde a instrução deve fazer parte da etapa de inicialização da conexão. Para mais informações, consulte Connection pools.

    Ativar exibição do ID de consulta

    select query_id, status, duration, query_start, application_name, command_tag
    from hologres.hg_query_log
    where query_id = '<QUERY_ID>';

    Instruções

    1. Leia o conteúdo em inglês para compreender O QUE precisa ser comunicado

    2. Escreva o texto em português do Brasil DO ZERO — esqueça a estrutura das frases em inglês

    3. Preserve toda a formatação markdown, blocos de código, links e imagens exatamente como estão

    4. Copie os placeholders xref ({XREF_N}) literalmente, sem traduzir ou modificar

    5. Aplique todas as regras específicas do idioma com rigor

    6. Siga as regras de stopwords com tolerância zero

    7. Use o modo imperativo em passos numerados e listas de procedimentos

    8. Garanta a consistência terminológica — o mesmo termo deve ter a mesma tradução em todo o documento

    9. Varie os inícios de frase em listas e tabelas — nenhum início deve se repetir mais de 3 vezes

    10. Retorne APENAS o documento markdown em português do Brasil, sem explicações

    Obter o query ID a partir de um cliente

    Os exemplos a seguir leem seu par de AccessKey das variáveis de ambiente ALIBABA_CLOUD_ACCESS_KEY_ID e ALIBABA_CLOUD_ACCESS_KEY_SECRET. Defina ambas as variáveis antes de executar os exemplos para evitar codificar credenciais diretamente no código.

    Java (JDBC)

    No JDBC, as mensagens NOTICE chegam como uma cadeia de objetos SQLWarning. Percorra essa cadeia com statement.getWarnings() após a execução do statement e extraia o query ID correspondente. O ResultSet não contém o query ID.

    select query_id, status, duration, query_start, application_name, command_tag
    from hologres.hg_query_log
    where query_id = '<QUERY_ID>';

    Instruções

    1. Leia o conteúdo em inglês para compreender O QUE precisa ser comunicado

    2. Escreva o texto em português do Brasil DO ZERO — esqueça a estrutura das frases em inglês

    3. Preserve toda a formatação markdown, blocos de código, links e imagens exatamente como estão

    4. Copie os placeholders xref ({XREF_N}) literalmente, sem traduzir ou modificar

    5. Aplique todas as regras específicas do idioma com rigor

    6. Siga as regras de stopwords com tolerância zero

    7. Use o modo imperativo em passos numerados e listas de procedimentos

    8. Garanta a consistência terminológica — o mesmo termo deve ter a mesma tradução em todo o documento

    9. Varie os inícios de frase em listas e tabelas — nenhum início deve se repetir mais de 3 vezes

    10. Retorne APENAS o documento markdown em português do Brasil, sem explicações

    Saída de exemplo:

    select query_id, status, duration, query_start, application_name, command_tag
    from hologres.hg_query_log
    where query_id = '<QUERY_ID>';

    Instruções

    1. Leia o conteúdo em inglês para compreender O QUE precisa ser comunicado

    2. Escreva o texto em português do Brasil DO ZERO — esqueça a estrutura das frases em inglês

    3. Preserve toda a formatação markdown, blocos de código, links e imagens exatamente como estão

    4. Copie os placeholders xref ({XREF_N}) literalmente, sem traduzir ou modificar

    5. Aplique todas as regras específicas do idioma com rigor

    6. Siga as regras de stopwords com tolerância zero

    7. Utilize o modo imperativo em etapas numeradas e listas de procedimentos

    8. Garanta a consistência terminológica — o mesmo termo deve ter a mesma tradução em todo o documento

    9. Varie os inícios de frase em listas e tabelas — nenhum início deve se repetir mais de 3 vezes

    10. Retorne APENAS o documento markdown em português do Brasil, sem explicações

    Observe o seguinte:

    • O funcionamento de PreparedStatement é semelhante. Execute pstmt.getWarnings() após a execução do statement.

    • Chame clearWarnings() antes de cada statement. Caso contrário, os avisos se acumulam no mesmo objeto Statement, impedindo a identificação correta do query ID associado a cada statement.

    • Uma cadeia de NOTICE pode conter mensagens não relacionadas, como um aviso de estatísticas ausentes. Ao fazer o parsing, utilize o prefixo QueryID: para realizar a correspondência.

    Python (Psycopg 3)

    O Hologres é compatível com o PostgreSQL 11. Utilize o driver Psycopg 3, que você instala com pip install "psycopg[binary]". Registre um callback com conn.add_notice_handler() para receber mensagens NOTICE. As linhas retornadas por cur.fetchall() não contêm o query ID.

    select query_id, status, duration, query_start, application_name, command_tag
    from hologres.hg_query_log
    where query_id = '<QUERY_ID>';

    Instruções

    1. Leia o conteúdo em inglês para compreender O QUE precisa ser comunicado

    2. Escreva o texto em português do Brasil DO ZERO — esqueça a estrutura das frases em inglês

    3. Preserve toda a formatação markdown, blocos de código, links e imagens exatamente como estão

    4. Copie os placeholders xref ({XREF_N}) literalmente, sem traduzir ou modificar

    5. Aplique todas as regras específicas do idioma com rigor

    6. Siga as regras de stopwords com tolerância zero

    7. Use o modo imperativo em passos numerados e listas de procedimentos

    8. Garanta a consistência terminológica — o mesmo termo deve ter a mesma tradução em todo o documento

    9. Varie os inícios de frase em listas e tabelas — nenhum início deve se repetir mais de 3 vezes

    10. Retorne APENAS o documento markdown em português do Brasil, sem explicações

    Saída de exemplo. Tanto instruções DML quanto consultas retornam um query ID:

    select query_id, status, duration, query_start, application_name, command_tag
    from hologres.hg_query_log
    where query_id = '<QUERY_ID>';

    Instruções

    1. Leia o conteúdo em inglês para compreender O QUE precisa ser comunicado

    2. Escreva o texto em português do Brasil DO ZERO — esqueça a estrutura das frases em inglês

    3. Preserve toda a formatação markdown, blocos de código, links e imagens exatamente como estão

    4. Copie os placeholders xref ({XREF_N}) literalmente, sem traduzir ou modificar

    5. Aplique todas as regras específicas de idioma com rigor

    6. Siga as regras de stopwords com tolerância zero

    7. Utilize o modo imperativo em passos numerados e listas de procedimentos

    8. Garanta a consistência terminológica — o mesmo termo deve ter a mesma tradução em todo o documento

    9. Varie os inícios de frase em listas e tabelas — nenhum início deve se repetir mais de 3 vezes

    10. Retorne APENAS o documento markdown em português do Brasil, sem explicações

    Instruções

    1. Leia o conteúdo em inglês para compreender O QUE precisa ser comunicado

    2. Escreva o texto em português do Brasil DO ZERO — esqueça a estrutura das frases em inglês

    3. Preserve toda a formatação markdown, blocos de código, links e imagens exatamente como estão

    4. Copie os placeholders xref ({XREF_N}) literalmente, sem traduzir ou modificar

    5. Aplique todas as regras específicas do idioma com rigor

    6. Siga as regras de stopwords com tolerância zero

    7. Use o modo imperativo em passos numerados e listas de procedimentos

    8. Garanta a consistência terminológica — o mesmo termo deve ter a mesma tradução em todo o documento

    9. Varie os inícios de frase em listas e tabelas — nenhum início deve se repetir mais de 3 vezes

    10. Retorne APENAS o documento markdown em português do Brasil, sem explicações

        Pools de conexão

        Como o parâmetro se aplica a uma única sessão, cada conexão física precisa dele. Ao utilizar um pool de conexões, defina-o na etapa de inicialização da conexão em vez de antes de cada consulta.

        O exemplo a seguir usa psycopg_pool para Python:

        select query_id, status, duration, query_start, application_name, command_tag
        from hologres.hg_query_log
        where query_id = '<QUERY_ID>';

        Para Java, utilize o SQL de inicialização do seu pool para garantir que o parâmetro esteja ativado em todas as conexões físicas. Os exemplos a seguir utilizam HikariCP e Druid:

        select query_id, status, duration, query_start, application_name, command_tag
        from hologres.hg_query_log
        where query_id = '<QUERY_ID>';

        Instruções

        1. Leia o conteúdo em inglês para compreender O QUE precisa ser comunicado

        2. Escreva o texto em português do Brasil DO ZERO — esqueça a estrutura das frases em inglês

        3. Preserve toda a formatação markdown, blocos de código, links e imagens exatamente como estão

        4. Copie os placeholders xref ({XREF_N}) literalmente, sem traduzir ou modificar

        5. Aplique todas as regras específicas do idioma com rigor

        6. Siga as regras de stopwords com tolerância zero

        7. Utilize o modo imperativo em passos numerados e listas de procedimentos

        8. Garanta a consistência terminológica — o mesmo termo deve ter a mesma tradução em todo o documento

        9. Varie os inícios de frase em listas e tabelas — nenhum início deve se repetir mais de 3 vezes

        10. Retorne APENAS o documento markdown em português do Brasil, sem explicações

        Após obter uma conexão do pool, você ainda pode recuperar o ID da consulta com statement.getWarnings() depois de cada instrução. Para mais informações, consulte Java (JDBC).

    Consultar detalhes de execução por query ID

    Com o query ID, é possível identificar a duração, o status, o número de linhas lidas e outros detalhes de uma consulta no log de consultas lentas:

    select query_id, status, duration, query_start, application_name, command_tag
    from hologres.hg_query_log
    where query_id = '<QUERY_ID>';

    Instruções

    Instruções

    1. Leia o conteúdo em inglês para compreender O QUE precisa ser comunicado

    2. Escreva o texto em português do Brasil DO ZERO — esqueça a estrutura das frases em inglês

    3. Preserve toda a formatação markdown, blocos de código, links e imagens exatamente como estão

    4. Copie os placeholders xref ({XREF_N}) literalmente, sem traduzir ou modificar

    5. Aplique todas as regras específicas do idioma rigorosamente

    6. Siga as regras de stopwords com tolerância zero

    7. Use o modo imperativo em passos numerados e listas de procedimentos

    8. Garanta a consistência terminológica — o mesmo termo deve ter a mesma tradução em todo o documento

    9. Varie os inícios de frase em listas e tabelas — nenhum início deve se repetir mais de 3 vezes

    10. Retorne APENAS o documento markdown em português do Brasil, sem explicações

    As gravações em hologres.hg_query_log apresentam uma latência de aproximadamente um minuto. Caso uma consulta recém-concluída ainda não esteja visível, aguarde alguns instantes e tente novamente.

    Observações de uso

    • Esse parâmetro se aplica a uma única sessão e é descartado quando a conexão é encerrada. Execute set hg_experimental_display_query_id = on; em cada nova conexão, caso contrário as consultas nessa conexão não retornarão um query ID.

    • Nem todo comando retorna um query ID. Comandos DDL como CREATE TABLE e DROP TABLE, além de consultas simples que não chegam ao mecanismo de computação, como select 1;, não retornam query ID. Esse comportamento é esperado. Já comandos DML como INSERT e consultas regulares como SELECT retornam o identificador normalmente.

    • Uma cadeia NOTICE pode conter outras mensagens, como um aviso de estatísticas ausentes. Faça a correspondência pelo prefixo QueryID: para evitar a captura de um valor incorreto.

    Solucionar problemas de query ID ausente

    Verifique os itens abaixo em ordem:

    1. Execute SHOW hg_experimental_display_query_id; para confirmar se o valor é on. Caso esteja como off, a conexão atual nunca executou a instrução — ao usar um pool de conexões, você pode ter recebido uma conexão diferente. Defina o parâmetro novamente ou revise a lógica de inicialização da sua conexão.

    2. Confira se alguma mensagem NOTICE foi recebida. Na ausência de mensagens, o servidor não enviou nada. Verifique se a versão da sua instância suporta o parâmetro e se o tipo de instrução gera um query ID.

    3. Se mensagens NOTICE chegaram, mas nenhum query ID foi extraído, o texto não corresponde à sua regra de parsing. Imprima a mensagem bruta e ajuste a regra para o formato retornado pela sua instância.

    4. Ao utilizar um pool de conexões, garanta que a instrução seja executada na etapa de inicialização da conexão, assegurando que todas as conexões físicas recebam a configuração.

Instruções

1. Leia o conteúdo em inglês para compreender O QUE precisa ser comunicado

2. Escreva o texto em português do Brasil DO ZERO — esqueça a estrutura das frases em inglês

3. Preserve toda a formatação markdown, blocos de código, links e imagens exatamente como estão

4. Copie os placeholders de xref ({XREF_N}) literalmente, sem traduzir ou modificar

5. Aplique todas as regras específicas de idioma com rigor

6. Siga as regras de stopwords com tolerância zero

7. Use o modo imperativo em passos numerados e listas de procedimentos

8. Garanta a consistência terminológica — o mesmo termo deve ter a mesma tradução em todo o documento

9. Varie os inícios de frase em listas e tabelas — nenhum início deve se repetir mais de 3 vezes

10. Retorne APENAS o documento markdown em português do Brasil, sem explicações