> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-trino-dialect.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> Contém uma lista de todos os handlers HTTP definidos em SQL e criados via CREATE HANDLER.

# system.handlers

<div id="description">
  ## Descrição
</div>

Contém uma lista de todos os handlers HTTP definidos em SQL e criados com [`CREATE HANDLER`](/pt-BR/reference/statements/create/handler).

A leitura desta tabela requer o privilégio `SHOW HANDLERS`; sem ele, ela aparece vazia. Secrets que
podem estar embutidos na consulta do handler (por exemplo, credenciais passadas para uma função de tabela) são exibidos nas
colunas `query` e `create_query` somente quando o usuário tem permissão para visualizar secrets (a configuração do servidor
`display_secrets_in_show_and_select` e a configuração de formato `format_display_secrets_in_show_and_select`
estão habilitadas, e o usuário possui o privilégio `displaySecretsInShowAndSelect`); caso contrário, são
mascarados, exatamente como em `SHOW CREATE TABLE`.

<div id="columns">
  ## Colunas
</div>

* `name` ([String](/pt-BR/reference/data-types/string)) — Nome do handler.
* `protocol` ([Nullable(String)](/pt-BR/reference/data-types/nullable)) — Protocolo composable ao qual o handler está restrito ou NULL se o handler estiver ativo em todos os endpoints HTTP (as portas `http`/`https` integradas e todos os listeners de protocolos composable do tipo HTTP).
* `url_match_type` ([String](/pt-BR/reference/data-types/string)) — Como a URL é correspondida: exata, por prefixo ou por regexp.
* `url` ([String](/pt-BR/reference/data-types/string)) — O padrão de URL ao qual o handler corresponde.
* `methods` ([Array(String)](/pt-BR/reference/data-types/array)) — Métodos HTTP permitidos.
* `type` ([String](/pt-BR/reference/data-types/string)) — O tipo de handler (somente `query` é compatível).
* `query` ([String](/pt-BR/reference/data-types/string)) — A consulta SQL executada pelo handler. Os Secrets ficam ocultos, a menos que o usuário tenha permissão para visualizá-los.
* `create_query` ([String](/pt-BR/reference/data-types/string)) — A instrução CREATE HANDLER. Os Secrets ficam ocultos, a menos que o usuário tenha permissão para visualizá-los.