Parâmetros¶

Hierarquia de parâmetros e tipos¶

Esta seção descreve os diferentes tipos de parâmetros (Conta, Sessão e Objeto) e os níveis nos quais cada tipo pode ser definido.

O diagrama a seguir ilustra a relação hierárquica entre os diferentes tipos de parâmetros e como parâmetros individuais podem ser substituídos em cada nível:

Visualização dos parâmetros e de seus valores¶

O Snowflake fornece o comando SHOW PARAMETERS, que exibe uma lista dos parâmetros, juntamente com os valores atuais e padrão para cada parâmetro. O comando pode ser chamado com diferentes opções para determinar o tipo de parâmetro exibido.

ABORT_DETACHED_QUERY¶

Tipo:

Sessão — Pode ser definido para Sessão do » Usuário » da Conta

Tipo de dados:

Booleano

Descrição:

Especifica a ação que o Snowflake executa para consultas em andamento se a conectividade for perdida devido à interrupção abrupta de uma sessão (por exemplo, interrupção da rede, interrupção do navegador ou interrupção do serviço).

Valores:

TRUE: Consultas em andamento são abortadas 5 minutos depois que a conectividade é perdida.

FALSE: Consultas em andamento são concluídas.

Padrão:

FALSE

ALLOW_CLIENT_MFA_CACHING¶

Tipo:

Conta — Só pode ser definido para Conta

Tipo de dados:

Booleano

Descrição:

Especifica se um token MFA pode ser salvo na keystore do sistema operacional do lado do cliente para promover conectividade contínua e segura sem que os usuários precisem responder a uma solicitação de MFA no início de cada tentativa de conexão ao Snowflake. Para obter mais detalhes e a lista de clientes suportados pelo Snowflake, consulte Uso do armazenamento em cache de tokens MFA para minimizar o número de tentativas durante a autenticação — opcional.

Valores:

TRUE: Armazena um token MFA na keystore do sistema operacional do lado do cliente para permitir que o aplicativo do cliente utilize o token MFA sempre que uma nova conexão for estabelecida. Enquanto for verdadeiro, os usuários não serão solicitados a responder a solicitações de MFA adicionais.

FALSE: Não armazena um token MFA. Os usuários devem responder a uma solicitação de MFA sempre que o aplicativo do cliente estabelecer uma nova conexão com o Snowflake.

Padrão:

FALSE

ALLOW_ID_TOKEN¶

Tipo:

Conta — Pode ser definido apenas para Conta

Tipo de dados:

Booleano

Descrição:

Especifica se um token de conexão pode ser salvo na chave do sistema operacional do lado do cliente para promover conectividade contínua e segura sem que os usuários precisem entrar com as credenciais de login no início de cada tentativa de conexão ao Snowflake. Para obter mais detalhes e a lista de clientes suportados pelo Snowflake, consulte Uso do cache de conexão para minimizar o número de tentativas de autenticação — Opcional.

Valores:

TRUE: Armazena um token de conexão na keystore do sistema operacional do lado do cliente para permitir que o aplicativo do cliente execute um SSO baseado em navegador sem que os usuários sejam solicitados a autenticar sempre que uma nova conexão for estabelecida.

FALSE: Não armazena uma ficha de conexão. Os usuários são solicitados a autenticar sempre que o aplicativo do cliente estabelece uma nova conexão com o Snowflake. Um SSO ao Snowflake ainda é possível se esse parâmetro for definido como falso.

Padrão:

FALSE

AUTOCOMMIT¶

Tipo:

Sessão — Pode ser definido para Sessão do » Usuário » da Conta

Tipo de dados:

Booleano

Descrição:

Especifica se a confirmação automática está habilitada para a sessão. A confirmação automática determina se uma instrução DML, quando executada sem uma transação ativa, é automaticamente comprometida depois que a instrução for concluída com sucesso. Para obter mais informações, consulte Transações.

Valores:

TRUE: A confirmação automática está habilitada.

FALSE: A confirmação automática está desativada, o que significa que instruções DML devem ser explicitamente confirmadas ou revertidas.

Padrão:

TRUE

AUTOCOMMIT_API_SUPPORTED (Somente exibição)¶

Tipo:

N/A

Tipo de dados:

Booleano

Descrição:

Somente para uso interno do Snowflake. Parâmetro somente de exibição que indica se o suporte da API para confirmação automática está habilitado para sua conta. Se o valor for TRUE, você pode ativar ou desativar a confirmação automática através das APIs para os seguintes drivers/conectores:

• Driver JDBC

• Driver ODBC

• Conector do Snowflake para Python

BINARY_INPUT_FORMAT¶

Tipo:

Sessão — Pode ser definido para Sessão do » Usuário » da Conta

Tipo de dados:

Cadeia de caracteres (constante)

Descrição:

O formato de valores VARCHAR passados como entrada para funções de conversão deVARCHAR para BINARY. Para obter mais informações, consulte Binary Input and Output.

Valores:

HEX, BASE64 ou UTF8 / UTF-8

Padrão:

HEX

BINARY_OUTPUT_FORMAT¶

Tipo:

Sessão — Pode ser definido para Sessão do » Usuário » da Conta

Tipo de dados:

Cadeia de caracteres (constante)

Descrição:

O formato para valores VARCHAR retornados como saída por funções de conversão de BINARYparaVARCHAR. Para obter mais informações, consulte Binary Input and Output.

Valores:

HEX ou BASE64

Padrão:

HEX

CATALOG¶

Tipo:

Objeto (para bancos de dados e esquemas) — Pode ser definido como Conta » Banco de dados » Esquema

Tipo de dados:

Cadeia de caracteres

Descrição:

Especifica uma integração de catálogo padrão para tabelas Iceberg. Para obter mais informações, consulte a documentação da tabela Iceberg.

Valores:

Qualquer identificador de integração de catálogo válido.

Padrão:

Nenhum

CLIENT_ENABLE_LOG_INFO_STATEMENT_PARAMETERS¶

Tipo:

Sessão — Pode ser definido apenas para Sessão

Tipo de dados:

Booleano

Clientes:

JDBC

Descrição:

Permite que os usuários registrem os valores de dados vinculados a PreparedStatements.

Para ver os valores, você deve não só definir esse parâmetro de nível de sessão para TRUE, mas também definir o parâmetro de conexão chamado TRACING para INFO ou ALL.

• Defina TRACING como ALL para ver todas as informações de depuração e todas as informações obrigatórias.

• Defina TRACING como INFO para ver os valores de parâmetros vinculados e menos outras informações de depuração.

Cuidado

Se você vincular informações confidenciais, tais como diagnósticos médicos ou senhas, essas informações serão registradas. O Snowflake recomenda certificar-se de que o arquivo de log seja seguro, ou somente usar dados de teste, quando você definir esse parâmetro como TRUE.

Valores:

TRUE ou FALSE.

Padrão:

FALSE

CLIENT_ENCRYPTION_KEY_SIZE¶

Tipo:

Conta — Pode ser definido apenas para Conta

Tipo de dados:

Inteiro

Clientes:

Qualquer

Descrição:

Especifica o tamanho da chave de criptografia AES, em bits, utilizada pelo Snowflake para criptografar/descriptografar arquivos armazenados em estágios internos (para carregamento/descarregamento de dados) quando você usa o tipo de criptografia SNOWFLAKE_FULL.

Valores:

128 ou 256

Padrão:

128

CLIENT_MEMORY_LIMIT¶

Tipo:

Sessão — Pode ser definido para Sessão do » Usuário » da Conta

Tipo de dados:

Inteiro

Clientes:

JDBC, ODBC

Descrição:

Parâmetro que especifica a quantidade máxima de memória que o driver JDBC ou ODBC deve usar para o conjunto de resultados de consultas (em MB).

Para o driver JDBC:

• Para simplificar o gerenciamento da memória da JVM, o parâmetro define um limite máximo de utilização de memória global para todas as consultas.

• CLIENT_RESULT_CHUNK_SIZE especifica o tamanho máximo de cada conjunto (ou parte) de resultados de consulta para download (em MB). O driver pode exigir memória adicional para processar uma parte; se isso ocorrer, ele ajustará o uso da memória durante a execução para processar pelo menos um thread/consulta. Verifique se o CLIENT_MEMORY_LIMIT está definido num valor consideravelmente mais alto do que o CLIENT_RESULT_CHUNK_SIZE para garantir que há uma disponibilidade de memória suficiente.

Para o driver ODBC:

• Esse parâmetro é suportado na versão 2.22.0 e superior.

• CLIENT_RESULT_CHUNK_SIZE não é suportado.

Valores:

Qualquer número válido de megabytes.

Padrão:

1536 (efetivamente 1,5 GB)

A maioria dos usuários não deve precisar definir este parâmetro. Se este parâmetro não for definido pelo usuário, o driver começa com o padrão especificado acima.

Além disso, o driver JDBC gerencia ativamente sua memória de forma conservadora para evitar o uso de toda a memória disponível.

CLIENT_METADATA_REQUEST_USE_CONNECTION_CTX¶

Tipo:

Sessão — Pode ser definido para Usuário » Sessão

Tipo de dados:

Booleano

Clientes:

JDBC, ODBC

Descrição:

Para funções ODBC e métodos JDBC específicos, esse parâmetro pode alterar o escopo de busca padrão de todos os bancos de dados/esquemas para o banco de dados/esquema atual. Normalmente, a busca mais específica retorna menos linhas e é executada mais rapidamente.

Por exemplo, o método getTables() do JDBC aceita um nome de banco de dados e um nome de esquema como argumentos, e retorna os nomes das tabelas do banco de dados e do esquema. Se os argumentos do banco de dados e esquemas forem null, por padrão, o método pesquisará todos os bancos de dados e todos os esquemas na conta. A definição CLIENT_METADATA_REQUEST_USE_CONNECTION_CTX para TRUE restringe a busca ao banco de dados e esquema atual especificado pelo contexto de conexão.

Em essência, a definição desse parâmetro para TRUE cria a seguinte precedência para o banco de dados e esquema:

1. Valores passados como argumentos para as funções/métodos.

2. Valores especificados no contexto de conexão (se houver).

3. Padrão (todos os bancos de dados e todos os esquemas).

Para obter mais detalhes, consulte as informações abaixo.

Esse parâmetro se aplica ao seguinte:

• Métodos de driver JDBC (para a classe DatabaseMetaData):

  • getColumns

  • getCrossReference

  • getExportedKeys

  • getForeignKeys

  • getFunctions

  • getImportedKeys

  • getPrimaryKeys

  • getSchemas

  • getTables

• Funções do driver ODBC:

  • SQLTables

  • SQLColumns

  • SQLPrimaryKeys

  • SQLForeignKeys

  • SQLGetFunctions

  • SQLProcedures

Valores:

TRUE: Se os argumentos do banco de dados e esquema são null, o driver recupera metadados apenas para o banco de dados e esquema especificado pelo contexto de conexão.

A interação é descrita com mais detalhes na tabela abaixo.

FALSE: Se os argumentos do banco de dados e esquemas forem null, o driver recupera metadados para todos os bancos de dados e esquemas da conta.

Padrão:

FALSE

Notas adicionais:

O contexto de conexão se refere ao banco de dados e esquema atual da sessão, que pode ser definido usando qualquer uma das seguintes opções:

1. Especificar o namespace padrão para o usuário que se conecta ao Snowflake (e inicia a sessão). Isso pode ser definido para o usuário através do comando CREATE USER ou ALTER USER, mas deve ser definido antes que o usuário se conecte.

2. Especificar o banco de dados e o esquema ao se conectar ao Snowflake através do driver.

3. Emitir um comando USE DATABASE ou USE SCHEMA dentro da sessão.

Se o banco de dados ou esquema tiver sido especificado por mais de um destes, o mais recente se aplica.

Quando CLIENT_METADATA_REQUEST_USE_CONNECTION_CTX está definido para TRUE:

Argumento do banco de dados	Argumento do esquema	Base de dados utilizada	Esquema utilizado
Não-nulo	Não-nulo	Argumento	Argumento
Não-nulo	Nulo	Argumento	Todos os esquemas
Nulo	Não-nulo	Contexto de conexão	Argumento
Nulo	Nulo	Contexto de conexão	Contexto de sessão

Se você quiser pesquisar somente o banco de dados do contexto de conexão, mas quiser pesquisar todos os esquemas dentro desse banco de dados, veja CLIENT_METADATA_USE_SESSION_DATABASE.

CLIENT_METADATA_USE_SESSION_DATABASE¶

Tipo:

Sessão — Pode ser definido para Sessão

Tipo de dados:

Booleano

Clientes:

JDBC

Descrição:

Esse parâmetro se aplica somente aos métodos afetados por CLIENT_METADATA_REQUEST_USE_CONNECTION_CTX.

Esse parâmetro se aplica somente quando ambas as condições a seguir são cumpridas:

• CLIENT_METADATA_REQUEST_USE_CONNECTION_CTX é FALSE ou não definido.

• Nenhum banco de dados ou esquema é passado para a função ODBC ou método JDBC relevante.

Para funções ODBC e métodos JDBC específicos, esse parâmetro pode alterar o escopo padrão de busca de todos os bancos de dados para o banco de dados atual. Normalmente, a busca mais específica retorna menos linhas e é executada mais rapidamente.

Para obter mais detalhes, consulte as informações abaixo.

Valores:

TRUE:

O driver pesquisa todos os esquemas no banco de dados do contexto de conexão. (Para obter mais detalhes sobre o contexto de conexão, veja a documentação para CLIENT_METADATA_REQUEST_USE_CONNECTION_CTX).

FALSE:

O driver pesquisa todos os esquemas em todos os bancos de dados.

Padrão:

FALSE

Notas adicionais:

Quando o banco de dados é null e o esquema é null e CLIENT_METADATA_REQUEST_USE_CONNECTION_CTX é FALSE:

CLIENT_METADATA_USE_SESSION_DATABASE	Comportamento
FALSE	Todos os esquemas em todos os bancos de dados são pesquisados.
TRUE	Todos os esquemas no banco de dados atual são pesquisados.

CLIENT_PREFETCH_THREADS¶

Tipo:

Sessão — Pode ser definido para Sessão do » Usuário » da Conta

Tipo de dados:

Inteiro

Clientes:

JDBC, ODBC, Python, .NET

Descrição:

Parâmetro que especifica o número de threads usados pelo cliente para pré-preencher grandes conjuntos de resultados. O driver tentará honrar o valor do parâmetro, mas define os valores mínimo e máximo (dependendo dos recursos do seu sistema) para melhorar o desempenho.

Valores:

1 a 10

Padrão:

4

A maioria dos usuários não deve precisar definir este parâmetro. Se esse parâmetro não for definido pelo usuário, o driver começará com o padrão especificado acima, mas também gerenciará ativamente sua contagem de threads de forma conservadora para evitar o uso de toda a memória disponível.

CLIENT_RESULT_CHUNK_SIZE¶

Tipo:

Sessão — Pode ser definido para Sessão do » Usuário » da Conta

Tipo de dados:

Inteiro

Clientes:

JDBC, SQL API

Descrição:

Parâmetro que especifica o tamanho máximo de cada conjunto (ou parte) de resultados de consulta para download (em MB). O driver JDBC baixa os resultados de consultas em partes.

Consulte também CLIENT_MEMORY_LIMIT.

Valores:

48 a 160

Padrão:

160

A maioria dos usuários não deve precisar definir este parâmetro. Se esse parâmetro não for definido pelo usuário, o driver começará com o padrão especificado acima, mas também gerenciará ativamente sua memória de forma conservadora para evitar o uso de toda a memória disponível.

CLIENT_RESULT_COLUMN_CASE_INSENSITIVE¶

Tipo:

Sessão — Pode ser definido para Sessão do » Usuário » da Conta

Tipo de dados:

Booleano

Clientes:

JDBC

Descrição:

Parâmetro que indica se o nome da coluna deve ser buscado sem diferenciar maiúsculas e minúsculas em métodos ResultSet.get* no JDBC.

Valores:

TRUE: busca os nomes das colunas sem diferenciar maiúsculas e minúsculas.

FALSE: busca os nomes das colunas diferenciando maiúsculas e minúsculas.

Padrão:

FALSE

CLIENT_SESSION_KEEP_ALIVE¶

Tipo:

Sessão — Pode ser definido para Sessão do » Usuário » da Conta

Tipo de dados:

Booleano

Clientes:

JDBC, ODBC, Python, Node.js

Descrição:

Parâmetro que indica se o usuário deve ser forçado a fazer o login novamente após um período de inatividade na sessão.

Valores:

TRUE: O Snowflake mantém a sessão ativa indefinidamente enquanto a conexão estiver ativa, mesmo que não haja atividade do usuário.

FALSE: O usuário deve fazer login novamente após quatro horas de inatividade.

Padrão:

FALSE

CLIENT_SESSION_KEEP_ALIVE_HEARTBEAT_FREQUENCY¶

Tipo:

Sessão — Pode ser definido para Sessão do » Usuário » da Conta

Tipo de dados:

Inteiro

Clientes:

SnowSQL, JDBC, Python, Node.js

Descrição:

Número de segundos entre as tentativas do cliente para atualizar o token para a sessão.

Valores:

900 a 3600

Padrão:

3600

CLIENT_TIMESTAMP_TYPE_MAPPING¶

Tipo:

Sessão — Pode ser definido para Sessão do » Usuário » da Conta

Tipo de dados:

Cadeia de caracteres (constante)

Clientes:

Qualquer

Descrição:

Especifica a variação TIMESTAMP_* a ser usada ao vincular variáveis de carimbo de data/hora para aplicativos JDBC ou ODBC que usam a API de vinculação para carregar dados.

Valores:

TIMESTAMP_LTZ ou TIMESTAMP_NTZ

Padrão:

TIMESTAMP_LTZ

DATA_RETENTION_TIME_IN_DAYS¶

Tipo:

Objeto (para bancos de dados, esquemas e tabelas) — Pode ser definido para Conta » Base de dados » Esquema » Tabela

Tipo de dados:

Inteiro

Descrição:

Número de dias para os quais o Snowflake retém dados históricos para realizar ações de Time Travel (SELECT, CLONE, UNDROP) no objeto. Um valor de 0 desabilita efetivamente o Time Travel para o banco de dados, esquema ou tabela especificado. Para obter mais informações, consulte Compreensão e uso do Time Travel.

Valores:

0 ou 1 (para Standard Edition)

0 para 90 (para Enterprise Edition ou superior)

Padrão:

1

DATE_INPUT_FORMAT¶

Tipo:

Sessão — Pode ser definido para Sessão do » Usuário » da Conta

Tipo de dados:

Cadeia de caracteres

Descrição:

Especifica o formato de entrada para o tipo de dados DATE. Para obter mais informações, consulte Formatos de entrada e saída de data e hora.

Valores:

Qualquer formato de data válido e suportado ou AUTO

(AUTO especifica que o Snowflake tenta detectar automaticamente o formato das datas armazenadas no sistema durante a sessão)

Padrão:

AUTO

DATE_OUTPUT_FORMAT¶

Tipo:

Sessão — Pode ser definido para Sessão do » Usuário » da Conta

Tipo de dados:

Cadeia de caracteres

Descrição:

Especifica o formato de exibição para o tipo de dados DATE. Para obter mais informações, consulte Formatos de entrada e saída de data e hora.

Valores:

Qualquer formato de data válido e suportado

Padrão:

YYYY-MM-DD

DEFAULT_DDL_COLLATION¶

Tipo:

Objeto (para bancos de dados, esquemas e tabelas) — Pode ser definido para Conta » Base de dados » Esquema » Tabela

Tipo de dados:

Cadeia de caracteres

Descrição:

Define o agrupamento padrão utilizado para as seguintes operações DDL:

• CREATE TABLE

• ALTER TABLE … ADD COLUMN

A definição desse parâmetro força todas as colunas criadas posteriormente nos objetos afetados (tabela, esquema, banco de dados ou conta) a ter o agrupamento especificado como padrão, a menos que o agrupamento da coluna esteja explicitamente definido no DDL.

Por exemplo, se DEFAULT_DDL_COLLATION = 'en-ci', as duas instruções a seguir são equivalentes:

create table test(c1 integer, c2 string, c3 string collate 'en-cs');

create table test(c1 integer, c2 string collate 'en-ci', c3 string collate 'en-cs');

Copy

Valores:

Qualquer especificação de agrupamento válido e suportado.

Padrão:

Cadeia de caracteres vazia

ENABLE_ETL_REPLICATION¶

ENABLE_IDENTIFIER_FIRST_LOGIN¶

Tipo:

Conta — Pode ser definido apenas para Conta

Tipo de dados:

Booleano

Descrição:

Determina o fluxo de login dos usuários. Quando ativado, o Snowflake solicita aos usuários seu nome de usuário ou endereço de e-mail antes de apresentar métodos de autenticação. Para obter mais detalhes, consulte Login com primeiro identificador.

Valores:

TRUE: Snowflake usa um fluxo de login com primeiro identificador para autenticar usuários.

FALSE: Snowflake apresenta todas as opções de login possíveis, mesmo que essas opções não se apliquem a um usuário específico.

Padrão:

FALSE

ENABLE_INTERNAL_STAGES_PRIVATELINK¶

Tipo:

Conta — Pode ser definido apenas para Conta

Tipo de dados:

Booleano

Descrição:

Especifica se a função SYSTEM$GET_PRIVATELINK_CONFIG retorna a chave private-internal-stages no resultado da consulta. O valor correspondente no resultado da consulta é usado durante o processo de configuração da conectividade privada para estágios internos.

Valores:

TRUE: Retorna a chave private-internal-stages e o valor no resultado da consulta.

FALSE: Não retorna a chave private-internal-stages e o valor no resultado da consulta.

Padrão:

FALSE

ENABLE_TRI_SECRET_AND_REKEY_OPT_OUT_FOR_IMAGE_REPOSITORY¶

Tipo:

Conta — Pode ser definido apenas para Conta

Tipo de dados:

Booleano

Descrição:

Especifica a opção do repositório de imagens para desativar Tri-Secret Secure e Periodic Rekeying.

Valores:

TRUE: desativa a Periodic Rekeying e Tri-Secret Secure para repositório de imagens.

FALSE: não permite a criação de um repositório de imagens para contas Tri-Secret Secure e de Periodic Rekeying. Da mesma forma, não permite a ativação do Tri-Secret Secure e da rechaveamento periódico para contas que ativaram o repositório de imagens.

Padrão:

FALSE

ENABLE_UNHANDLED_EXCEPTIONS_REPORTING¶

Tipo:

Sessão — Pode ser definido para Sessão do » Usuário » da Conta

Tipo de dados:

Booleano

Descrição:

Especifica se o Snowflake pode capturar – em uma tabela de eventos – mensagens de log ou rastrear dados de eventos para exceções não tratadas no código do manipulador da UDF ou procedimento. Para obter mais informações, consulte Captura de mensagens de exceções não tratadas.

Valores:

TRUE: os dados sobre exceções não tratadas serão capturados como dados de log ou de rastreamento se a criação de log e o rastreamento estiverem ativados.

FALSE: os dados sobre exceções não tratadas não são capturados.

Padrão:

TRUE

ENABLE_UNLOAD_PHYSICAL_TYPE_OPTIMIZATION¶

Tipo:

Sessão — Pode ser definido para Sessão do » Usuário » da Conta

Tipo de dados:

Booleano

Descrição:

Especifica se o esquema para arquivos Parquet descarregados deve ser definido com base nos tipos de dados da coluna lógica (isto é, os tipos na consulta de descarregamento SQL ou tabela de origem de descarregamento) ou nos valores das colunas descarregadas (isto é, os menores tipos de dados e precisão que oferecem suporte para os valores nas colunas de saída da instrução de descarregamento SQL ou tabela de origem).

Valores:

TRUE: O esquema dos arquivos de dados de Parquet descarregados é determinado pelos valores da coluna na consulta de descarregamentoSQL ou tabela de origem. O Snowflake otimiza as colunas da tabela ao definir a menor precisão que aceita todos os valores. O descarregador segue esse padrão ao escrever valores em arquivos Parquet. O tipo de dados e a precisão de uma coluna de saída são definidos para o menor tipo de dados e precisão que oferecem suporte para seus valores na instrução de descarregamento SQL ou tabela de origem. Aceite essa configuração para obter um melhor desempenho e arquivos de dados menores.

FALSE: O esquema é determinado pelos tipos de dados da coluna lógica. Defina este valor para um esquema de arquivo de saída consistente.

Padrão:

TRUE

ENABLE_UNREDACTED_QUERY_SYNTAX_ERROR¶

Tipo:

Usuário — Pode ser definido para Conta » Usuário

Tipo de dados:

Booleano

Descrição:

Controla se o texto da consulta é excluído se uma consulta SQL falhar devido a um erro de sintaxe ou de análise. Se FALSE, o conteúdo de uma consulta com falha é editado nas exibições, páginas e funções que fornecem um histórico de consulta.

Somente os usuários com uma função que recebeu ou herdou o privilégio AUDIT podem definir o parâmetro ENABLE_UNREDACTED_QUERY_SYNTAX_ERROR.

Ao usar o comando ALTER USER para definir o parâmetro como TRUE para um determinado usuário, modifique o usuário que deseja ver o texto da consulta, não o usuário que executou a consulta (se forem usuários diferentes).

Valores:

TRUE: desabilita a exclusão do texto da consulta para consultas que falham devido a um erro de sintaxe ou análise.

FALSE: exclui o conteúdo de uma consulta das exibições, páginas e funções que fornecem um histórico de consulta quando uma consulta falha devido a um erro de sintaxe ou análise.

Padrão:

FALSE

ENFORCE_NETWORK_RULES_FOR_INTERNAL_STAGES¶

Tipo:

Conta — Pode ser definido apenas para Conta

Tipo de dados:

Booleano

Descrição:

Especifica se uma política de redes que usa regras de rede pode restringir o acesso a estágios internos de AWS.

Este parâmetro não tem efeito nas políticas de redes que não utilizam regras de rede.

Esse parâmetro no nível da conta afeta as políticas de rede no nível da conta e no nível do usuário.

Para obter detalhes sobre o uso de políticas e regras de rede para restringir o acesso a estágios internos de AWS, incluindo o uso deste parâmetro, consulte Proteção de estágios internos no AWS.

Valores:

TRUE: permite políticas de redes que usam regras de rede para restringir o acesso a estágios internos de AWS. A regra de rede também deve usar MODE e TYPE apropriados para restringir o acesso ao estágio interno.

FALSE: as políticas de redes nunca restringem o acesso a estágios internos.

Padrão:

FALSE

ERROR_ON_NONDETERMINISTIC_MERGE¶

Tipo:

Sessão — Pode ser definido para Sessão do » Usuário » da Conta

Tipo de dados:

Booleano

Descrição:

Especifica se um erro deve ser retornado quando o comando MERGE é usado para atualizar ou excluir uma linha de destino que une várias linhas de origem e o sistema não pode determinar a ação a ser executada na linha de destino.

Valores:

TRUE: É retornado um erro que inclui valores de uma das linhas de destino que causaram o erro.

FALSE: Nenhum erro é retornado e a fusão é concluída com sucesso, mas os resultados da fusão não são determinísticos.

Padrão:

TRUE

ERROR_ON_NONDETERMINISTIC_UPDATE¶

Tipo:

Sessão — Pode ser definido para Sessão do » Usuário » da Conta

Tipo de dados:

Booleano

Descrição:

Especifica se um erro deve ser retornado quando o comando UPDATE é usado para atualizar uma linha de destino que une várias linhas de origem e o sistema não pode determinar a ação a ser executada na linha de destino.

Valores:

TRUE: É retornado um erro que inclui valores de uma das linhas de destino que causaram o erro.

FALSE: Nenhum erro é retornado e a atualização é concluída, mas os resultados da atualização não são determinísticos.

Padrão:

FALSE

EVENT_TABLE¶

Tipo:

Conta — Pode ser definido apenas para Conta

Tipo de dados:

Cadeia de caracteres

Descrição:

Especifica o nome da tabela de eventos para registrar mensagens de procedimentos armazenados e UDFs nessa conta.

Valores:

Qualquer tabela de eventos existente criada com a execução do comando CREATE EVENT TABLE.

Padrão:

Nenhum

EXTERNAL_OAUTH_ADD_PRIVILEGED_ROLES_TO_BLOCKED_LIST¶

Tipo:

Conta — Pode ser definido apenas para Conta

Tipo de dados:

Booleano

Descrição:

Determina se as funções ACCOUNTADMIN, ORGADMIN e SECURITYADMIN podem ser usadas como função principal ao criar uma sessão do Snowflake com base no token de acesso do servidor de autorização OAuth externa.

Valores:

TRUE: adicione as funções ORGADMIN, ACCOUNTADMIN e SECURITYADMIN à propriedade EXTERNAL_OAUTH_BLOCKED_ROLES_LIST da integração de segurança OAuth externa, o que significa que estas funções não podem ser usadas como a função principal ao criar uma sessão do Snowflake usando uma autenticação OAuth externa.

FALSE: remove ACCOUNTADMIN, ORGADMIN e SECURITYADMIN da lista de funções bloqueadas definidas pela propriedade EXTERNAL_OAUTH_BLOCKED_ROLES_LIST da integração de segurança OAuth externa.

Padrão:

TRUE

EXTERNAL_VOLUME¶

Tipo:

Objeto (para bancos de dados e esquemas) — Pode ser definido como Conta » Banco de dados » Esquema

Tipo de dados:

Cadeia de caracteres

Descrição:

Especifica um volume externo padrão para tabelas Iceberg. Para obter mais informações, consulte a documentação da tabela Iceberg.

Valores:

Qualquer identificador de volume externo válido.

Padrão:

Nenhum

GEOGRAPHY_OUTPUT_FORMAT¶

Tipo:

Sessão — Pode ser definido para Sessão do » Usuário » da Conta

Tipo de dados:

Cadeia de caracteres (constante)

Descrição:

Formato de exibição de valores GEOGRAPHY.

Para EWKT e EWKB, o SRID é sempre 4326 na saída. Consulte a nota sobre como lidar com EWKT e EWKB.

Valores:

GeoJSON WKT, WKB, EWKT ou EWKB

Padrão:

GeoJSON

GEOMETRY_OUTPUT_FORMAT¶

Tipo:

Sessão — Pode ser definido para Sessão do » Usuário » da Conta

Tipo de dados:

Cadeia de caracteres (constante)

Descrição:

Formato de exibição de valores GEOMETRY.

Valores:

GeoJSON WKT, WKB, EWKT ou EWKB

Padrão:

GeoJSON

INITIAL_REPLICATION_SIZE_LIMIT_IN_TB¶

Tipo:

Conta — Pode ser definido apenas para Conta

Tipo de dados:

Número.

Descrição:

Define o tamanho máximo estimado para a replicação inicial de um banco de dados primário para um banco de dados secundário (em TB). Define este parâmetro em qualquer conta que armazene um banco de dados secundário. Esse limite de tamanho ajuda a evitar que contas incorram acidentalmente em grandes taxas de replicação de banco de dados.

Para remover o limite de tamanho, defina o valor para 0.0.

Observe que atualmente não há um limite de tamanho padrão aplicado a atualizações posteriores de um banco de dados secundário.

Valores:

0.0 e acima com uma escala de pelo menos 1 (por exemplo, 20.5, 32.25, 33.333, etc.).

Padrão:

10.0

JDBC_ENABLE_PUT_GET¶

Tipo:

Sessão — Pode ser definido para Sessão do » Usuário » da Conta

Tipo de dados:

Booleano

Descrição:

Especifica se é permitido permitir o acesso dos comandos PUT e GET aos sistemas de arquivos locais.

Valores:

TRUE: JDBC ativa os comandos PUT e GET.

FALSE: JDBC desativa os comandos PUT e GET.

Padrão:

TRUE

JDBC_TREAT_DECIMAL_AS_INT¶

Tipo:

Sessão — Pode ser definido para Sessão do » Usuário » da Conta

Tipo de dados:

Booleano

Descrição:

Especifica como o JDBC processa colunas que têm uma escala de zero (0).

Valores:

TRUE: O JDBC processa uma coluna cuja escala é zero como BIGINT.

FALSE: O JDBC processa uma coluna cuja escala é zero como DECIMAL.

Padrão:

TRUE

JDBC_TREAT_TIMESTAMP_NTZ_AS_UTC¶

Tipo:

Sessão — Pode ser definido para Sessão do » Usuário » da Conta

Tipo de dados:

Booleano

Descrição:

Especifica como o JDBC processa valores TIMESTAMP_NTZ.

Por padrão, quando o driver JDBC busca um valor do tipo TIMESTAMP_NTZ do Snowflake, ele converte o valor para o horário «wallclock» usando o fuso horário JVM do cliente.

Os usuários que desejam manter o fuso horário UTC para a conversão podem definir esse parâmetro como TRUE.

Esse parâmetro se aplica somente ao driver JDBC.

Valores:

TRUE: o driver usa UTC para obter o valor TIMESTAMP_NTZ no horário «wallclock».

FALSE: o driver usa o fuso horário atual do cliente JVM para obter o valor TIMESTAMP_NTZ no horário «wallclock».

Padrão:

FALSE

JDBC_USE_SESSION_TIMEZONE¶

Tipo:

Sessão — Pode ser definido para Sessão do » Usuário » da Conta

Tipo de dados:

Booleano

Descrição:

Especifica se o driver JDBC usa o fuso horário da classe da JVM ou o fuso horário da sessão (especificado pelo parâmetro TIMEZONE) para os métodos getDate(), getTime() e getTimestamp() da classe ResultSet.

Valores:

TRUE: O driver JDBC usa o fuso horário da sessão.

FALSE: O driver JDBC utiliza o fuso horário da JVM.

Padrão:

TRUE

JSON_INDENT¶

Tipo:

Sessão — Pode ser definido para Sessão do » Usuário » da Conta

Tipo de dados:

Inteiro

Descrição:

Especifica o número de espaços em branco para recuar cada novo elemento na saída JSON na sessão. Especifica também se caracteres de nova linha devem ser inseridos após cada elemento.

Valores:

0 a 16

(um valor de 0 retorna uma saída compacta removendo todos os espaços em branco e caracteres de nova linha da saída)

Padrão:

2

JS_TREAT_INTEGER_AS_BIGINT¶

Tipo:

Sessão — Pode ser definido para Sessão

Tipo de dados:

Booleano

Descrição:

Especifica como o driver Node.js do Snowflake processa colunas numéricas que têm uma escala de zero (0), por exemplo INTEGER ou NUMBER(p, 0).

Valores:

TRUE: JavaScript processa uma coluna cuja escala é zero como Bigint.

FALSE: JavaScript processa uma coluna cuja escala é zero como Number.

Padrão:

FALSE

LOCK_TIMEOUT¶

Tipo:

Sessão — Pode ser definido para Sessão do » Usuário » da Conta

Tipo de dados:

Número

Descrição:

Número de segundos a esperar enquanto se tenta bloquear um recurso antes de dar o time out e abortar a instrução.

Valores:

0 para qualquer número (ou seja, sem limite) Um valor de 0 desativa a espera de bloqueio (ou seja, a instrução deve adquirir o bloqueio imediatamente ou abortar). Se vários recursos precisarem ser bloqueados pela instrução, o tempo limite se aplica separadamente a cada tentativa de bloqueio

Padrão:

43200 (ou seja, 12 horas)

LOG_LEVEL¶

Tipo:

Sessão — Pode ser definido para Sessão do » Usuário » da Conta

Tipo:

Objeto (para bancos de dados, esquemas, procedimentos armazenados e UDFs) — Pode ser definido para a conta » Banco de dados » Esquema » Procedimento e conta » Banco de dados » Esquema » Função

Tipo de dados:

Cadeia de caracteres (constante)

Descrição:

Especifica o nível de gravidade das mensagens que devem ser ingeridas e disponibilizadas na tabela de eventos ativos. As mensagens no nível especificado (e em níveis mais graves) são ingeridas. Para obter mais informações sobre os níveis de registro, consulte Configuração do nível de registro.

Valores:

• TRACE

• DEBUG

• INFO

• WARN

• ERROR

• FATAL

• OFF

Padrão:

OFF

Notas adicionais:

A tabela a seguir lista os níveis de mensagens ingeridas quando você define o parâmetro LOG_LEVEL como um nível.

Configuração do parâmetro LOG_LEVEL	Níveis de mensagens ingeridas
TRACE	TRACE DEBUG INFO WARN ERROR FATAL
DEBUG	DEBUG INFO WARN ERROR FATAL
INFO	INFO WARN ERROR FATAL
WARN	WARN ERROR FATAL
ERROR	ERROR FATAL
FATAL	ERROR (Somente para UDFs de Java, UDTFs de Java e procedimentos armazenados em Java e Scala. Para obter mais informações, consulte Explicação dos níveis de log) FATAL

Se esse parâmetro for definido tanto na sessão quanto no objeto (ou esquema, banco de dados ou conta), será usado o valor mais detalhado. Consulte Como o Snowflake determina o nível de registro efetivo.

MAX_CONCURRENCY_LEVEL¶

Tipo:

Objeto (para warehouses) — Pode ser definido para Conta » Warehouse

Tipo de dados:

Número

Descrição:

Especifica o nível de concorrência para SQL instruções (ou seja, consultas e DML) executadas por um warehouse. Quando o nível é atingido, a operação realizada depende de se o warehouse é de um único ou de múltiplos clusters:

• cluster único ou multicluster (no modo Maximizado): As instruções são enfileiradas até que os recursos já alocados sejam liberados ou recursos adicionais sejam provisionados, o que pode ser realizado aumentando o tamanho do warehouse.

• Multicluster (em modo de dimensionamento automático): Clusters adicionais são iniciados.

MAX_CONCURRENCY_LEVEL pode ser usado em conjunto com o parâmetro STATEMENT_QUEUED_TIMEOUT_IN_SECONDS para garantir que um warehouse nunca fique em atraso.

Em geral, ele limita o número de instruções que podem ser executadas simultaneamente por um cluster de warehouse, mas há exceções. Nos casos a seguir, o número real de instruções executadas simultaneamente por um warehouse pode ser maior ou menor do que o nível especificado:

• Instruções menores, mais básicas: Mais instruções podem ser executadas simultaneamente porque instruções pequenas geralmente são executadas em um subconjunto dos recursos computacionais disponíveis em um warehouse. Isso significa que eles contam apenas como uma fração para o nível de concorrência.

• Instruções maiores e mais complexas: Menos instruções podem ser executadas simultaneamente.

Padrão:

8

MAX_DATA_EXTENSION_TIME_IN_DAYS¶

Tipo:

Objeto (para bancos de dados, esquemas e tabelas) — Pode ser definido para Conta » Base de dados » Esquema » Tabela

Tipo de dados:

Inteiro

Descrição:

Número máximo de dias para os quais o Snowflake pode estender o período de retenção de dados das tabelas para evitar que os fluxos nas tabelas se tornem obsoletos. Por padrão, se a configuração DATA_RETENTION_TIME_IN_DAYS para uma tabela de fontes for inferior a 14 dias e um fluxo não tiver sido consumido, o Snowflake estende temporariamente esse período para a compensação do fluxo, até um máximo de 14 dias, independentemente da Edição do Snowflake para sua conta. O parâmetro MAX_DATA_EXTENSION_TIME_IN_DAYS permite limitar esse período de extensão automática para controlar os custos de armazenamento para retenção de dados ou por razões de compliance.

Esse parâmetro pode ser definido nos níveis de conta, banco de dados, esquema e tabela. Observe que a definição do parâmetro no nível de conta ou esquema só afeta as tabelas para as quais o parâmetro ainda não foi explicitamente definido em um nível inferior (por exemplo, no nível da tabela pelo proprietário da tabela). Um valor de 0 desabilita efetivamente a extensão automática para o banco de dados, esquema ou tabela especificado. Para obter mais informações sobre fluxos e desatualização, consulte Rastreamento de alterações usando fluxos de tabela.

Valores:

0 para 90 (isso é, 90 dias) — um valor de 0 desativa a extensão automática do período de retenção de dados. Para aumentar o valor máximo de tabelas em sua conta, entre em contato com o suporte Snowflake.

Padrão:

14

MULTI_STATEMENT_COUNT¶

Tipo:

Sessão — Pode ser definido para Sessão do » Usuário » da Conta

Tipo de dados:

Integer (constante)

Clientes:

SQL API, JDBC, .NET, ODBC

Descrição:

Número de instruções a serem executadas ao usar a capacidade de instruções múltiplas.

Valores:

0: Número variável de instruções.

1: Uma instrução.

Mais do que 1: Quando MULTI_STATEMENT_COUNT é definido como parâmetro de sessão, é possível especificar o número exato de instruções a serem executadas.

Números negativos não são permitidos.

Padrão:

1

MIN_DATA_RETENTION_TIME_IN_DAYS¶

Tipo:

Conta — Pode ser definido apenas para Conta

Tipo de dados:

Inteiro

Descrição:

Número mínimo de dias para os quais o Snowflake retém dados históricos para realizar ações de Time Travel (SELECT, CLONE, UNDROP) sobre um objeto. Se um número mínimo de dias para retenção de dados for definido em uma conta, o período de retenção de dados para um objeto é determinado por MAX(DATA_RETENTION_TIME_IN_DAYS, MIN_DATA_RETENTION_TIME_IN_DAYS).

Para obter mais informações, consulte Compreensão e uso do Time Travel.

Valores:

0 ou 1 (para Standard Edition)

0 para 90 (para Enterprise Edition ou superior)

Padrão:

0

NETWORK_POLICY¶

Tipo:

Conta — Pode ser definido apenas para Conta (pode ser definido por administradores de conta e administradores de segurança)

Tipo:

Objeto (para usuários) — Pode ser definido para Conta » Usuário

Tipo de dados:

Cadeia de caracteres

Descrição:

Especifica a política de redes a ser aplicada para sua conta. As políticas de redes permitem restringir o acesso à sua conta com base no endereço IP dos usuários. Para obter mais detalhes, consulte Controle do tráfego de rede com políticas de rede.

Valores:

Qualquer política de redes existente (criada usando CREATE NETWORK POLICY)

Padrão:

Nenhum

NOORDER_SEQUENCE_AS_DEFAULT¶

Tipo:

Sessão — Pode ser definido para Sessão do » Usuário » da Conta

Tipo de dados:

Booleano

Descrição:

Especifica se a propriedade ORDER ou NOORDER é definida por padrão quando você cria uma nova sequência ou adiciona uma nova coluna de tabela.

As propriedades ORDER e NOORDER determinam se os valores são ou não gerados para a sequência ou coluna incrementada automaticamente em ordem crescente ou decrescente.

Valores:

• TRUE: quando você cria uma nova sequência ou adiciona uma nova coluna de tabela, a propriedade NOORDER é definida por padrão.

  NOORDER especifica que não é garantido que os valores estejam em ordem crescente.

  Por exemplo, se uma sequência tiver START 1 INCREMENT 2, os valores gerados poderão ser 1, 3, 101, 5, 103 etc.

  NOORDER pode melhorar o desempenho quando várias operações de inserção precisam ser executadas simultaneamente (por exemplo, quando vários clientes estão executando várias instruções INSERT).

• FALSE: quando você cria uma nova sequência ou adiciona uma nova coluna de tabela, a propriedade ORDER é definida por padrão.

  ORDER especifica que os valores gerados para uma sequência ou coluna incrementada automaticamente estão em ordem crescente (ou, se o intervalor for um valor negativo, em ordem decrescente).

  Por exemplo, se uma sequência ou coluna incrementada automaticamente tiver START 1 INCREMENT 2, os valores gerados poderão ser 1, 3, 5, 7, 9 etc.

Se você definir esse parâmetro, o valor definido substituirá o valor no pacote de mudança de comportamento 2024_01.

Padrão:

TRUE

ODBC_TREAT_DECIMAL_AS_INT¶

Tipo:

Sessão — Pode ser definido para Sessão do » Usuário » da Conta

Tipo de dados:

Booleano

Descrição:

Especifica como o ODBC processa colunas que têm uma escala de zero (0).

Valores:

TRUE: O ODBC processa uma coluna cuja escala é zero como BIGINT.

FALSE: O ODBC processa uma coluna cuja escala é zero como DECIMAL.

Padrão:

FALSE

OAUTH_ADD_PRIVILEGED_ROLES_TO_BLOCKED_LIST¶

Tipo:

Conta — Pode ser definido apenas para Conta

Tipo de dados:

Booleano

Descrição:

Determina se as funções ACCOUNTADMIN, ORGADMIN e SECURITYADMIN podem ser usadas como função principal ao criar uma sessão do Snowflake com base no token de acesso do servidor de autorização do Snowflake.

Valores:

TRUE: adiciona as funções ORGADMIN, ACCOUNTADMIN e SECURITYADMIN à propriedade BLOCKED_ROLES_LIST da integração de segurança OAuth do Snowflake, o que significa que estas funções não podem ser usadas como a função principal ao criar uma sessão do Snowflake usando o OAuth do Snowflake.

FALSE: remove ACCOUNTADMIN, ORGADMIN e SECURITYADMIN da lista de funções bloqueadas definidas pela propriedade BLOCKED_ROLES_LIST da integração de segurança OAuth do Snowflake.

Padrão:

TRUE

PERIODIC_DATA_REKEYING¶

Tipo:

Conta — Pode ser definido apenas para Conta

Tipo de dados:

Booleano

Descrição:

Esse parâmetro só se aplica à Enterprise Edition (ou superior). Ele permite/desativa a recriptografia de dados de tabela com novas chaves anualmente para fornecer níveis adicionais de proteção de dados.

Você pode habilitar e desabilitar a recodificação a qualquer momento. Habilitar/desabilitar a recodificação não resulta em lacunas em seus dados criptografados:

• Se a recodificação for ativada por um período e depois desativada, todos os dados já marcados para recodificação serão recodificados, mas nenhum outro dado será recodificado novamente até que você reative a opção.

• Se a recodificação for ativada, o Snowflake recodificará automaticamente todos os dados com chaves que atendam aos critérios (ou seja, a chave tem mais que um ano).

Para obter mais informações sobre a recodificação de dados criptografados, consulte Explicação do gerenciamento de chaves de criptografia no Snowflake.

Valores:

TRUE: Os dados são recodificados novamente após um ano após a última criptografia. A recodificação ocorre em segundo plano para que não haja tempo de parada e os dados/tabela afetados estejam sempre disponíveis.

FALSE: Os dados não são recodificados.

Padrão:

FALSE

PIPE_EXECUTION_PAUSED¶

Tipo:

Objeto — Pode ser definido para Conta » Esquema » Canal

Tipo de dados:

Booleano

Descrição:

Especifica se um canal em funcionamento deve ser pausado, principalmente na preparação para transferir a propriedade do canal para uma função diferente:

• Um administrador de conta (usuário com a função ACCOUNTADMIN) pode definir esse parâmetro no nível da conta, efetivamente pausando ou retomando todos os canais da conta.

• Um usuário com o privilégio MODIFY sobre um esquema pode pausar ou retomar todos os canais do esquema.

• O proprietário do canal pode definir esse parâmetro para um canal.

Observe que a definição do parâmetro no nível de conta ou esquema só afeta canais para os quais o parâmetro ainda não foi explicitamente definido em um nível inferior (por exemplo, no nível do canal pelo proprietário do canal).

Isso permite o caso de uso prático no qual um administrador de conta pode pausar todos os canais no nível da conta, enquanto um proprietário de canal ainda pode ter um tubo individual funcionando.

Valores:

TRUE: Pausa o canal. Quando o parâmetro está definido para esse valor, a função SYSTEM$PIPE_STATUS mostra o executionState como PAUSED. Observe que o proprietário do canal pode continuar a enviar arquivos para um canal pausado; no entanto, os arquivos não são processados até que o canal seja retomado.

FALSE: Retoma o canal, mas somente se a propriedade do canal não tiver sido transferida enquanto ele estava pausado. Quando o parâmetro está definido para esse valor, a função SYSTEM$PIPE_STATUS mostra o executionState como RUNNING.

Se a propriedade do canal tiver sido transferida para outra função após a pausa do canal, esse parâmetro não poderá ser usado para retomar o canal. Em vez disso, use a função SYSTEM$PIPE_FORCE_RESUME para forçar o canal a ser retomado explicitamente.

Isso permite que o novo proprietário use SYSTEM$PIPE_STATUS para avaliar o estado do canal (por exemplo, determinar quantos arquivos estão esperando para serem carregados) antes de retomar o canal.

Padrão:

FALSE (canais estão funcionando por padrão)

PREVENT_UNLOAD_TO_INLINE_URL¶

Tipo:

Conta — Pode ser definido apenas para Conta

Tipo de dados:

Booleano

Descrição:

Especifica se devem-se evitar operações ad hoc de descarregamento de dados em locais externos de armazenamento em nuvem (ou seja, instruções COPY INTO <local> que especificam a URL de armazenamento em nuvem e configurações de acesso diretamente na instrução). Para obter um exemplo, consulte Descarregamento de dados de uma tabela diretamente para arquivos em um local externo.

Valores:

TRUE: Instruções COPY INTO <location> devem fazer referência a um estágio interno (Snowflake) ou externo nomeado ou a um usuário interno ou estágio de tabela. Um estágio externo nomeado deve armazenar a URL de armazenamento em nuvem e as configurações de acesso em sua definição.

FALSE: São permitidas operações ad hoc de descarregamento de dados para locais externos de armazenamento em nuvem.

Padrão:

FALSE

PREVENT_UNLOAD_TO_INTERNAL_STAGES¶

Tipo:

Usuário — Pode ser definido para Conta » Usuário

Tipo de dados:

Booleano

Descrição:

Especifica se devem-se evitar operações de descarga de dados em etapas internas (Snowflake) usando instruções COPY INTO <local>.

Valores:

TRUE: O descarregamento de dados de tabelas do Snowflake para qualquer estágio interno, incluindo estágios de usuários, estágios de tabelas ou estágios internos nomeados é impedido.

FALSE: É permitido o descarregamento de dados em estágios internoss, limitado apenas pelas restrições padrão do tipo de estágio:

• O usuário atual só pode descarregar dados para seu próprio estágio de usuário.

• Usuários só podem descarregar dados para estágios de tabela quando sua função ativa tiver o privilégio OWNERSHIP sobre a tabela.

• Usuários só podem descarregar dados para estágios internos nomeados quando sua função ativa tiver o privilégio WRITE no estágio.

Padrão:

FALSE

QUERY_TAG¶

Tipo:

Sessão — Pode ser definido para Sessão do » Usuário » da Conta

Tipo de dados:

Cadeia de caracteres (até 2.000 caracteres)

Descrição:

Cadeia de caracteres opcional que pode ser usada para marcar consultas e outras instruções SQL executadas dentro de uma sessão. As tags são exibidas na saída das funções QUERY_HISTORY , QUERY_HISTORY_BY_*.

Padrão:

Nenhum

QUOTED_IDENTIFIERS_IGNORE_CASE¶

Tipo:

Sessão — Pode ser definido para Sessão do » Usuário » da Conta

Objeto — Pode ser definido para Conta » Base de dados » Esquema » Tabela

Tipo de dados:

Booleano

Descrição:

Especifica se letras em identificadores de objetos com aspas duplas são armazenadas e resolvidas como letras maiúsculas. Por padrão, o Snowflake preserva a caixa de caracteres alfabéticos ao armazenar e resolver identificadores com aspas duplas. (consulte Resolução do identificador). Você pode usar esse parâmetro em situações nas quais aplicativos de terceiros sempre usam aspas duplas em torno de identificadores.

Nota

Alterar este parâmetro do valor padrão pode afetar sua capacidade de encontrar objetos que foram previamente criados com identificadores incluindo maiúsculas e minúsculas com aspas duplas. Consulte Impacto da alteração de parâmetro.

Quando definida em uma tabela, esquema ou banco de dados, a configuração só afeta a avaliação dos nomes das tabelas nos corpos de exibições e funções definidas pelo usuário (UDFs). Se sua conta usa identificadores com aspas duplas que devem ser tratados sem diferenciar maiúsculas de minúsculas e você planeja compartilhar uma exibição ou UDF com uma conta que trata identificadores com aspas duplas diferenciando maiúsculas de minúsculas, você pode definir isso na exibição ou UDF que você planeja compartilhar. Isso permite que a outra conta resolva os nomes das tabelas corretamente na exibição ou na UDF.

Valores:

TRUE: Letras em identificadores com aspas duplas são armazenadas e resolvidas como letras maiúsculas.

FALSE: A caixa das letras em identificadores com aspas duplas é preservado. O Snowflake resolve e armazena os identificadores na caixa especificada.

Para obter mais informações, consulte Resolução do identificador.

Padrão:

FALSE

Por exemplo:

REQUIRE_STORAGE_INTEGRATION_FOR_STAGE_CREATION¶

Tipo:

Conta — Pode ser definido apenas para Conta

Tipo de dados:

Booleano

Descrição:

Especifica se é necessário um objeto de integração de armazenamento como credenciais de nuvem ao criar um estágio externo nomeado (usando CREATE STAGE) para acessar um local privado de armazenamento em nuvem.

Valores:

TRUE: A criação de um estágio externo para acessar um local privado de armazenamento em nuvem requer fazer referência a um objeto de integração de armazenamento como credenciais de nuvem.

FALSE: A criação de um estágio externo não requer fazer referência a um objeto de integração de armazenamento. Em vez disso, os usuários podem fazer referência explícita às credenciais do provedor da nuvem, tais como chaves secretas ou tokens de acesso, caso elas tenham sido configuradas para o local de armazenamento.

Padrão:

FALSE

REQUIRE_STORAGE_INTEGRATION_FOR_STAGE_OPERATION¶

Tipo:

Conta — Pode ser definido apenas para Conta

Tipo de dados:

Booleano

Descrição:

Especifica se é necessário utilizar um estágio externo nomeado que referencia um objeto de integração de armazenamento como credenciais de nuvem ao carregar ou descarregar dados para um local privado de armazenamento em nuvem.

Valores:

TRUE: O carregamento ou descarregamento de dados para um local privado de armazenamento em nuvem requer o uso de um estágio externo nomeado que referencia um objeto de integração de armazenamento; especificar um estágio externo nomeado que referencia credenciais explícitas de provedores de nuvem, tais como chaves secretas ou tokens de acesso, produz um erro do usuário.

FALSE: Os usuários podem carregar ou descarregar dados para um local privado de armazenamento em nuvem usando um estágio externo nomeado que faz referência explícita às credenciais do provedor da nuvem.

Se PREVENT_UNLOAD_TO_INLINE_URL for FALSE, os usuários podem especificar as credenciais explícitas do provedor da nuvem diretamente na instrução COPY.

Padrão:

FALSE

ROWS_PER_RESULTSET¶

Tipo:

Sessão — Pode ser definido para Sessão do » Usuário » da Conta

Tipo de dados:

Número

Clientes:

SQL API

Descrição:

Especifica o número máximo de linhas retornadas em um conjunto de resultados.

Valores:

0 para qualquer número (ou seja, sem limite) — um valor de 0 não especifica nenhum máximo.

Padrão:

0

S3_STAGE_VPCE_DNS_NAME¶

Tipo:

Sessão — Pode ser definido para Sessão do » Usuário » da Conta

Tipo de dados:

Cadeia de caracteres

Descrição:

Especifica o nome DNS de um ponto de extremidade de interface do Amazon S3. As solicitações enviadas para o estágio interno de uma conta por meio de AWS PrivateLink para Amazon S3 usam esse ponto de extremidade para se conectar.

Para obter mais informações, consulte Acesso a estágios internos com pontos de extremidade de interface dedicados.

Valores:

Nome DNS com escopo de região válido de um ponto de extremidade de interface S3.

O formato padrão começa com um asterisco (*) e termina com vpce.amazonaws.com (por exemplo, *.vpce-sd98fs0d9f8g.s3.us-west-2.vpce.amazonaws.com). Para obter mais detalhes sobre como obter esse valor, consulte Configuração do AWS.

Os formatos alternativos incluem bucket.vpce-xxxxxxxx.s3.<região>.vpce.amazonaws.com e vpce-xxxxxxxx.s3.<região>.vpce.amazonaws.com.

Padrão:

Cadeia de caracteres vazia

SAML_IDENTITY_PROVIDER¶

Tipo:

Conta — Pode ser definido apenas para Conta

Tipo de dados:

JSON

Descrição:

Permite a autenticação federada. Este parâmetro obsoleto permite uma autenticação federada. Este parâmetro aceita um objeto JSON entre aspas simples com os seguintes campos:

{
  "certificate": "",
  "issuer": "",
  "ssoUrl": "",
  "type"  : "",
  "label" : ""
}

Copy

Onde:

certificate

Especifica o certificado (gerado pelo IdP) que verifica a comunicação entre o IdP e o Snowflake.

issuer

Indica o emissor/EntityID do IdP.

Opcional.

Para saber como obter esse valor em Okta e AD FS, consulte Migração para uma integração de segurança SAML2.

ssoUrl

Especifica o ponto de extremidade da URL (fornecido pelo IdP) para onde o Snowflake envia as solicitações SAML.

type

Especifica o tipo de IdP usado para autenticação federada ("OKTA", "ADFS", "Custom").

label

Especifica o texto do botão do IdP na página de login do Snowflake. A etiqueta padrão é Single Sign On. Se você mudar o rótulo padrão, o rótulo especificado só poderá conter caracteres alfanuméricos (ou seja, caracteres especiais e espaços em branco não são suportados atualmente).

Observe que, se o campo "type" for "Okta", um valor para o campo label não precisa ser especificado porque Snowflake exibe o logotipo Okta no botão.

Para obter mais informações, incluindo exemplos de definição do parâmetro, consulte Migração para uma integração de segurança SAML2.

Padrão:

Nenhum

SEARCH_PATH¶

Tipo:

Sessão — Pode ser definido para Sessão do » Usuário » da Conta

Tipo de dados:

Cadeia de caracteres

Descrição:

Especifica o caminho a ser pesquisado para resolver nomes de objetos não qualificados em consultas. Para obter mais informações, consulte Resolução de nomes em consultas.

Valores:

Lista de identificadores separados por vírgula. Um identificador pode ser um nome de esquema total ou parcialmente qualificado.

Padrão:

$current, $public

Para obter mais informações sobre as configurações padrão, consulte o caminho de pesquisa padrão.

SIMULATED_DATA_SHARING_CONSUMER¶

Tipo:

Sessão — Pode ser definido para Sessão do » Usuário » da Conta

Tipo de dados:

Cadeia de caracteres

Descrição:

Especifica o nome de uma conta de consumidor para simular para testar/validar dados compartilhados, particularmente exibições seguras compartilhadas. Quando esse parâmetro é definido em uma sessão, as exibições compartilhadas retornarão linhas como se fossem executadas na conta do consumidor especificado e não na conta do provedor.

Nota

As simulações só têm sucesso quando a função atual é a proprietária da exibição. Se a função atual não for a proprietária da exibição, as simulações falharão com o erro:

Shared view consumer simulation requires that the executing role owns the view.

Copy

Para obter mais informações, consulte Introdução ao Secure Data Sharing e Como trabalhar com compartilhamentos.

Padrão:

Nenhum

SSO_LOGIN_PAGE¶

Tipo:

Conta — Pode ser definido apenas para Conta

Tipo de dados:

Booleano

Descrição:

Este parâmetro obsoleto desativa o modo de versão preliminar para testar o SSO (após habilitar a autenticação federada) antes de estendê-la aos usuários:

Valores:

TRUE: O modo de pré-visualização está desativado e os usuários verão o botão para o SSO iniciado para o Snowflake para seu provedor de identidade (como especificado em SAML_IDENTITY_PROVIDER) na página principal de login do Snowflake.

FALSE: O modo de pré-visualização é ativado e o SSO pode ser testado usando a seguinte URL:

• Se sua conta está na região US West: https://<account_identifier>.snowflakecomputing.com/console/login?fedpreview=true

• Se sua conta estiver em qualquer outra região: https://<account_identifier>.<region_id>.snowflakecomputing.com/console/login?fedpreview=true

Para obter mais informações, consulte:

• Migração para uma integração de segurança SAML2

• Identificadores de conta

Padrão:

FALSE

STATEMENT_QUEUED_TIMEOUT_IN_SECONDS¶

Tipo:

Sessão e Objeto (para warehouses)

Pode ser definido para Conta » Usuário » Sessão; também pode ser definido para warehouses individuais

Tipo de dados:

Número

Descrição:

Quantidade de tempo, em segundos, em que uma instrução SQL (consulta, DDL, DML, etc.) permanece em fila para um warehouse antes de ser cancelada pelo sistema. Esse parâmetro pode ser usado em conjunto com o parâmetro MAX_CONCURRENCY_LEVEL para garantir que um warehouse nunca fique em atraso.

O parâmetro pode ser definido dentro da hierarquia da sessão. Também pode ser definido para um warehouse para controlar o tempo limite da fila para todas as instruções SQL processadas pelo warehouse. Quando o parâmetro é definido tanto para um warehouse quanto para uma sessão, aplica-se o valor mais baixo que não seja zero. Por exemplo:

• Um warehouse tem um tempo limite de fila de 120 segundos.

• O tempo limite de fila para a sessão está definido para 60 segundos.

O tempo limite da sessão tem precedência (ou seja, qualquer instrução apresentada na sessão é cancelada após ser colocada em fila por mais de 60 segundos).

Nota

Para execuções de tarefas, o parâmetro de tarefa USER_TASK_TIMEOUT_MS tem precedência sobre a configuração STATEMENT_QUEUED_TIMEOUT_IN_SECONDS.

Ao comparar os valores desses dois parâmetros, observe que STATEMENT_QUEUED_TIMEOUT_IN_SECONDS é definido em unidades de segundos, enquanto USER_TASK_TIMEOUT_MS utiliza unidades de milissegundos.

Para obter mais informações sobre USER_TASK_TIMEOUT_MS, consulte a seção Parâmetros Opcionais de CREATE TASK.

Valores:

0 para qualquer número (ou seja, sem limite) — um valor de 0 especifica que nenhum tempo limite é aplicado. Uma instrução permanecerá enfileirada enquanto a fila persistir.

Padrão:

0 (ou seja, sem tempo limite)

STATEMENT_TIMEOUT_IN_SECONDS¶

Tipo:

Sessão e Objeto (para warehouses)

Pode ser definido para Conta » Usuário » Sessão; também pode ser definido para warehouses individuais

Tipo de dados:

Número

Descrição:

Quantidade de tempo, em segundos, após a qual uma instrução SQL em execução (consulta, DDL, DML, etc.) é cancelada pelo sistema.

O parâmetro pode ser definido dentro da hierarquia da sessão. Ele também pode ser definido para um warehouse individual para controlar o tempo de execução de todas as instruções SQL processadas pelo warehouse. Quando o parâmetro é definido tanto para um warehouse quanto para uma sessão, aplica-se o valor mais baixo que não seja zero. Por exemplo:

• Um warehouse tem um tempo limite de 1000 segundos.

• O tempo limite para a sessão está definido para 500 segundos.

O tempo limite da sessão tem precedência (ou seja, qualquer instrução apresentada na sessão é cancelada depois de correr por mais de 500 segundos).

Nota

Para execuções de tarefas:

• Se uma tarefa depende de um warehouse virtual para seus recursos computacionais e STATEMENT_TIMEOUT_IN_SECONDS está definido no nível do depósito, o tempo limite efetivo é o menor dos seguintes parâmetros:

  • STATEMENT_TIMEOUT_IN_SECONDS

  • USER_TASK_TIMEOUT_MS (parâmetro definido na tarefa)

• Caso contrário, o parâmetro USER_TASK_TIMEOUT_MS da tarefa tem precedência sobre a configuração STATEMENT_TIMEOUT_IN_SECONDS de execução de tarefas.

Ao comparar os valores desses dois parâmetros, observe que STATEMENT_TIMEOUT_IN_SECONDS é definido em unidades de segundos, enquanto USER_TASK_TIMEOUT_MS utiliza unidades de milissegundos.

Para obter mais informações sobre USER_TASK_TIMEOUT_MS, consulte a seção Parâmetros Opcionais de CREATE TASK.

Valores:

0 para 604800 (isso é, 7 dias) — um valor de 0 especifica que o valor máximo de tempo limite é aplicado.

Padrão:

172800 (ou seja, 2 dias)

STRICT_JSON_OUTPUT¶

Tipo:

Sessão — Pode ser definido para Sessão do » Usuário » da Conta

Tipo de dados:

Booleano

Descrição:

Esse parâmetro especifica se a saída JSON em uma sessão é compatível com o padrão geral (como descrito por http://json.org).

O Snowflake foi projetado de forma a permitir entradas JSON contendo valores não-padronizados; entretanto, esses valores não-padronizados podem fazer com que o Snowflake retorne um JSON incompatível com outras plataformas e linguagens. Esse parâmetro, quando ativado, garante que o Snowflake produza um JSON válido/compatível.

Valores:

TRUE: Saída JSON estrita habilitada, impondo o seguinte comportamento:

• Valores ausentes e indefinidos na entrada são mapeados para JSON NULL.

• Valores numéricos não finitos na entrada (Infinity, -Infinity, NaN, etc.) são mapeados para cadeias de caracteres com representações JavaScript válidas. Isso permite compatibilidade com JavaScript e também permite a conversão desses valores de volta para valores numéricos.

FALSE: A saída estrita JSON não está habilitada.

Padrão:

FALSE

Por exemplo:

SUSPEND_TASK_AFTER_NUM_FAILURES¶

Tipo:

Objeto (para bancos de dados, esquemas e tabelas) — Pode ser definido como Conta » Base de dados » Esquema » Tarefa

Tipo de dados:

Inteiro

Descrição:

Número de tarefas consecutivas falhadas, após as quais uma tarefa autônoma ou gráfico de tarefa tarefa de raiz é suspensa automaticamente. Execuções de tarefas falhadas incluem execuções nas quais o código SQL no corpo da tarefa produz um erro do usuário ou atinge o tempo limite. Execuções de tarefas que são puladas, canceladas ou que falham devido a um erro do sistema são consideradas indeterminadas e não são incluídas na contagem de execuções de tarefas falhadas.

Quando o parâmetro é definido como 0, a tarefa com falha não é suspensa automaticamente.

Quando o parâmetro é definido como um valor maior que 0, o seguinte comportamento se aplica a execuções de tarefas autônomas ou tarefas de raiz do gráfico da tarefa:

• Uma tarefa autônoma é automaticamente suspensa após o número especificado de execuções consecutivas de tarefas falhar ou atingir o tempo limite.

• Uma tarefa raiz é automaticamente suspensa após a execução de qualquer tarefa única em um gráfico da tarefa falhar ou atingir o tempo limite pelo número especificado de vezes, em execuções consecutivas.

O valor padrão do parâmetro é definido como 10, o que significa que a tarefa é suspensa automaticamente após 10 execuções consecutivas de tarefas com falha.

Quando você define explicitamente o valor do parâmetro no nível da conta, do banco de dados ou do esquema, a alteração é aplicada às tarefas contidas no objeto modificado durante sua próxima execução programada (incluindo qualquer tarefa filho em uma execução de gráfico da tarefa em andamento).

A suspensão de uma tarefa autônoma reinicia sua contagem de execuções de tarefas falhadas. Suspender a tarefa raiz de um gráfico da tarefa redefine a contagem de cada tarefa no gráfico da tarefa.

Valores:

0 - Sem limite superior.

Padrão:

10

TIMESTAMP_DAY_IS_ALWAYS_24H¶

Tipo:

Sessão — Pode ser definido para Sessão do » Usuário » da Conta

Tipo de dados:

Booleano

Descrição:

Especifica se a função DATEADD (e seus pseudônimos) sempre considera um dia como exatamente 24 horas para expressões que abrangem vários dias.

Valores:

TRUE: Um dia é sempre exatamente 24 horas.

FALSE: Um dia nem sempre é 24 horas.

Padrão:

FALSE

alter session set TIMESTAMP_DAY_IS_ALWAYS_24H = true;

-- With DST beginning on 2018-03-11 at 2 AM, America/Los_Angeles time zone
select dateadd(day, 1, '2018-03-10 09:00:00'::TIMESTAMP_LTZ), dateadd(day, 1, '2018-11-03 09:00:00'::TIMESTAMP_LTZ);

+-------------------------------------------------------+-------------------------------------------------------+
| DATEADD(DAY, 1, '2018-03-10 09:00:00'::TIMESTAMP_LTZ) | DATEADD(DAY, 1, '2018-11-03 09:00:00'::TIMESTAMP_LTZ) |
|-------------------------------------------------------+-------------------------------------------------------|
| 2018-03-11 10:00:00.000 -0700                         | 2018-11-04 08:00:00.000 -0800                         |
+-------------------------------------------------------+-------------------------------------------------------+

alter session set TIMESTAMP_DAY_IS_ALWAYS_24H = false;

select dateadd(day, 1, '2018-03-10 09:00:00'::TIMESTAMP_LTZ), dateadd(day, 1, '2018-11-03 09:00:00'::TIMESTAMP_LTZ);

+-------------------------------------------------------+-------------------------------------------------------+
| DATEADD(DAY, 1, '2018-03-10 09:00:00'::TIMESTAMP_LTZ) | DATEADD(DAY, 1, '2018-11-03 09:00:00'::TIMESTAMP_LTZ) |
|-------------------------------------------------------+-------------------------------------------------------|
| 2018-03-11 09:00:00.000 -0700                         | 2018-11-04 09:00:00.000 -0800                         |
+-------------------------------------------------------+-------------------------------------------------------+

TIMESTAMP_INPUT_FORMAT¶

Tipo:

Sessão — Pode ser definido para Sessão do » Usuário » da Conta

Tipo de dados:

Cadeia de caracteres

Descrição:

Especifica o formato de entrada para o tipo de dados alias TIMESTAMP. Para obter mais informações, consulte Formatos de entrada e saída de data e hora.

Valores:

Qualquer formato de carimbo de data/hora válido e suportado ou AUTO

(AUTO especifica que o Snowflake tenta detectar automaticamente o formato dos carimbos de data/hora armazenados no sistema durante a sessão)

Padrão:

AUTO

TIMESTAMP_LTZ_OUTPUT_FORMAT¶

Tipo:

Sessão — Pode ser definido para Sessão do » Usuário » da Conta

Tipo de dados:

Cadeia de caracteres

Descrição:

Especifica o formato de exibição para o tipo de dados TIMESTAMP_LTZ. Se nenhum formato for especificado, será usado o padrão TIMESTAMP_OUTPUT_FORMAT. Para obter mais informações, consulte Formatos de entrada e saída de data e hora.

Valores:

Qualquer formato de carimbo de data/hora válido e suportado

Padrão:

Nenhum

TIMESTAMP_NTZ_OUTPUT_FORMAT¶

Tipo:

Sessão — Pode ser definido para Sessão do » Usuário » da Conta

Tipo de dados:

Cadeia de caracteres

Descrição:

Especifica o formato de exibição para o tipo de dados TIMESTAMP_NTZ.

Valores:

Qualquer formato de carimbo de data/hora válido e suportado

Padrão:

YYYY-MM-DD HH24:MI:SS.FF3

TIMESTAMP_OUTPUT_FORMAT¶

Tipo:

Sessão — Pode ser definido para Sessão do » Usuário » da Conta

Tipo de dados:

Cadeia de caracteres

Descrição:

Especifica o formato de exibição para o tipo de dados alias TIMESTAMP. Para obter mais informações, consulte Formatos de entrada e saída de data e hora.

Valores:

Qualquer formato de carimbo de data/hora válido e suportado

Padrão:

YYYY-MM-DD HH24:MI:SS.FF3 TZHTZM

TIMESTAMP_TYPE_MAPPING¶

Tipo:

Sessão — Pode ser definido para Sessão do » Usuário » da Conta

Tipo de dados:

Cadeia de caracteres

Descrição:

Especifica a variação de TIMESTAMP_* que é mapeada para o tipo de dados alias TIMESTAMP.

Valores:

TIMESTAMP_LTZ, TIMESTAMP_NTZ ou TIMESTAMP_TZ

Padrão:

TIMESTAMP_NTZ

TIMESTAMP_TZ_OUTPUT_FORMAT¶

Tipo:

Sessão — Pode ser definido para Sessão do » Usuário » da Conta

Tipo de dados:

Cadeia de caracteres

Descrição:

Especifica o formato de exibição para o tipo de dados TIMESTAMP_TZ. Se nenhum formato for especificado, será usado o padrão TIMESTAMP_OUTPUT_FORMAT. Para obter mais informações, consulte Formatos de entrada e saída de data e hora.

Valores:

Qualquer formato de carimbo de data/hora válido e suportado

Padrão:

Nenhum

TIMEZONE¶

Tipo:

Sessão — Pode ser definido para Sessão do » Usuário » da Conta

Tipo de dados:

Cadeia de caracteres (constante)

Descrição:

Especifica o fuso horário para a sessão.

Valores:

Você pode especificar um nome de fuso horário ou um nome de link do lançamento 2021a do Banco de Dados de Fusos Horários IANA (por exemplo, America/Los_Angeles, Europe/London, UTC, Etc/GMT, etc.).

Padrão:

America/Los_Angeles

TIME_INPUT_FORMAT¶

Tipo:

Sessão — Pode ser definido para Sessão do » Usuário » da Conta

Tipo de dados:

Cadeia de caracteres

Descrição:

Especifica o formato de entrada para o tipo de dados TIME. Para obter mais informações, consulte Formatos de entrada e saída de data e hora.

Valores:

Qualquer formato de tempo válido e suportado ou AUTO

(AUTO especifica que o Snowflake tenta detectar automaticamente o formato dos horários armazenados no sistema durante a sessão)

Padrão:

AUTO

TIME_OUTPUT_FORMAT¶

Tipo:

Sessão — Pode ser definido para Sessão do » Usuário » da Conta

Tipo de dados:

Cadeia de caracteres

Descrição:

Especifica o formato de exibição para o tipo de dados TIME. Para obter mais informações, consulte Formatos de entrada e saída de data e hora.

Valores:

Qualquer formato de tempo válido e suportado

Padrão:

HH24:MI:SS

TRACE_LEVEL¶

Tipo:

Sessão — Pode ser definido para Sessão do » Usuário » da Conta

Tipo:

Objeto (para bancos de dados, esquemas, procedimentos armazenados e UDFs) — Pode ser definido para a conta » Banco de dados » Esquema » Procedimento e conta » Banco de dados » Esquema » Função

Tipo de dados:

Cadeia de caracteres (constante)

Descrição:

Controla como os eventos de rastreamento são ingeridos na tabela de eventos. Para obter mais informações sobre níveis de rastreamento, consulte Configuração do nível de rastreamento.

Valores:

ALWAYS: todos os eventos de spans e rastreamento serão registrados na tabela de eventos.

ON_EVENT: os eventos de rastreamento serão registrados na tabela de eventos somente quando os procedimentos armazenados ou UDFs adicionarem eventos explicitamente.

OFF: nenhum período ou evento de rastreamento será registrado na tabela de eventos.

Padrão:

OFF

TRANSACTION_ABORT_ON_ERROR¶

Tipo:

Sessão — Pode ser definido para Sessão do » Usuário » da Conta

Tipo de dados:

BOOLEAN

Descrição:

Especifica a ação a ser executada quando uma instrução emitida dentro de uma transação sem confirmação automática retorna com um erro.

Valores:

TRUE: A transação sem confirmação automática é abortada. Todas as instruções emitidas dentro dessa transação falharão até que uma instrução de confirmação ou de reversão seja executada para encerrar essa transação.

FALSE: A transação sem confirmação automática não é abortada.

Padrão:

FALSE

TRANSACTION_DEFAULT_ISOLATION_LEVEL¶

Tipo:

Sessão — Pode ser definido para Sessão do » Usuário » da Conta

Tipo de dados:

Cadeia de caracteres

Descrição:

Especifica o nível de isolamento para transações na sessão do usuário.

Valores:

READ COMMITTED (somente valor suportado atualmente)

Padrão:

READ COMMITTED

TWO_DIGIT_CENTURY_START¶

Tipo:

Sessão — Pode ser definido para Sessão do » Usuário » da Conta

Tipo de dados:

Número

Descrição:

Especifica o ano de “início do século” para anos com 2 dígitos (ou seja, o ano mais antigo que tais datas podem representar). Esse parâmetro evita datas ambíguas ao importar ou converter dados com o componente de formato de data YY (ou seja, anos representados como 2 dígitos).

Valores:

De 1900 a 2100 (qualquer valor fora deste intervalo retorna um erro)

Padrão:

1970

Por exemplo:

UNSUPPORTED_DDL_ACTION¶

Tipo:

Sessão — Pode ser definido para Sessão do » Usuário » da Conta

Tipo de dados:

Cadeia de caracteres (constante)

Descrição:

Determina se um valor não suportado (ou seja, não padrão) especificado para uma propriedade de restrição retorna um erro.

Valores:

IGNORE: O Snowflake não retorna um erro para valores não suportados.

FAIL: O Snowflake retorna um erro para valores não suportados.

Padrão:

IGNORE

USE_CACHED_RESULT¶

Tipo:

Sessão — Pode ser definido para Sessão do » Usuário » da Conta

Tipo de dados:

Booleano

Descrição:

Especifica se é necessário reutilizar os resultados da consulta persistente, se disponíveis, quando uma consulta correspondente é enviada.

Valores:

TRUE: Quando uma consulta é enviada, o Snowflake verifica os resultados da consulta correspondente para consultas executadas anteriormente e, se existir um resultado correspondente, usa o resultado em vez de executar a consulta. Isso pode ajudar a reduzir o tempo de consulta, pois o Snowflake recupera o resultado diretamente do cache.

FALSE: O Snowflake executa cada consulta que é enviada, independentemente da existência de um resultado de consulta correspondente.

Padrão:

TRUE

USER_TASK_MANAGED_INITIAL_WAREHOUSE_SIZE¶

Tipo:

Objeto (para bancos de dados, esquemas e tabelas) — Pode ser definido como Conta » Base de dados » Esquema » Tarefa

Tipo de dados:

Cadeia de caracteres

Descrição:

Especifica o tamanho dos recursos de computação a serem provisionados para a primeira execução da tarefa, antes que um histórico de tarefas esteja disponível para que o Snowflake determine um tamanho ideal. Quando uma tarefa é concluída com sucesso, o Snowflake ignora esta configuração de parâmetros. Se o histórico de tarefas não estiver disponível para uma determinada tarefa, os recursos de computação voltam para esse tamanho inicial.

Nota

Esse parâmetro se aplica somente a tarefas sem servidor.

O tamanho é equivalente aos recursos computacionais disponíveis ao criar um warehouse. Se o parâmetro for omitido, as primeiras execuções da tarefa são realizadas utilizando um warehouse de tamanho médio (MEDIUM).

Você pode mudar o tamanho inicial para tarefas individuais (usando ALTER TASK) após a criação da tarefa, mas antes de ela já ter sido executada com sucesso uma vez. A alteração do parâmetro após a primeira execução desta tarefa não tem efeito sobre os recursos de computação para execuções de tarefa atuais ou futuras.

Observe que suspender e retomar uma tarefa não remove o histórico de tarefas usado para dimensionar os recursos de computação. O histórico de tarefas só é removido se a tarefa for recriada (usando a sintaxe CREATE OR REPLACE TASK).

Valores:

Qualquer tamanho de warehouse tradicional: SMALL, MEDIUM, LARGE, etc., com um tamanho máximo de XXLARGE.

Padrão:

MEDIUM

USER_TASK_TIMEOUT_MS¶

Tipo:

Objeto (para bancos de dados, esquemas e tabelas) — Pode ser definido como Conta » Base de dados » Esquema » Tarefa

Tipo de dados:

Número

Descrição:

Especifica o limite de tempo em uma única execução da tarefa antes que ele se esgote (em milissegundos).

Nota

• Antes de aumentar significativamente o prazo para tarefas, considere se as instruções SQL nas definições de tarefas podem ser otimizadas (seja reescrevendo as instruções ou usando procedimentos armazenados) ou se o tamanho do warehouse para tarefas com recursos computacionais gerenciados pelo usuário deve ser aumentado.

• Em algumas situações, o parâmetro STATEMENT_TIMEOUT_IN_SECONDS tem maior precedência do que USER_TASK_TIMEOUT_MS. Para obter mais detalhes, consulte STATEMENT_TIMEOUT_IN_SECONDS.

Valores:

0 - 86400000 (1 dia).

Padrão:

3600000 (1 hora)

WEEK_OF_YEAR_POLICY¶

Tipo:

Sessão — Pode ser definido para Sessão do » Usuário » da Conta

Tipo de dados:

Número

Descrição:

Especifica como as semanas em um determinado ano são computadas.

Valores:

0: A semântica utilizada é equivalente à semântica ISO, na qual uma semana pertence a um determinado ano se pelo menos 4 dias dessa semana estiverem nesse ano.

1: 1º de janeiro está incluído na primeira semana do ano e 31 de dezembro está incluído na última semana do ano.

Padrão:

0 (ou seja, comportamento semelhante ao ISO)

WEEK_START¶

Tipo:

Sessão — Pode ser definido para Sessão do » Usuário » da Conta

Tipo de dados:

Número

Descrição:

Especifica o primeiro dia da semana (usado por funções de data relacionadas à semana).

Valores:

0: Usa o comportamento legado do Snowflake (ou seja, semântica semelhante ao ISO).

1 (segunda-feira) a 7 (domingo): todas as funções relacionadas à semana utilizam semanas que começam no dia da semana especificado.

Padrão:

0 (ou seja, comportamento legado do Snowflake)