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

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

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_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 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 forem ativados conforme descrito em Habilitação de captura de entradas de exceção não tratadas.

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

Padrão

FALSE

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

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 Políticas de rede.

Valores

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

Padrão

Nenhum

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

SHARE_RESTRICTIONS¶

Tipo

Objeto (para compartilhamentos) — Pode ser definido como Share.

Tipo de dados

Booleano

Descrição

Este parâmetro só se aplica ao compartilhamento de dados. Ele ativa/desativa a opção de adicionar uma conta de consumidor não-Crítico para os Negócios a um compartilhamento pertencente a uma conta de provedor Crítico para os Negócios. Para obter mais informações, consulte Habilitação do compartilhamento de uma conta Business Critical para outro tipo de conta.

Valores

FALSE: Uma conta de consumidor não-Crítico para os Negócios pode ser adicionada a um compartilhamento pertencente a uma conta de provedor Crítico para os Negócios.

TRUE: Uma conta de consumidor não-Crítico para os Negócios não pode ser adicionada a um compartilhamento pertencente a uma conta de provedor Crítico para os Negócios.

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 DAG 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 DAG:

• 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 DAG 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.

A configuração se aplica a tarefas que dependem de recursos computacionais gerenciados pelo Snowflake (ou seja, modelo computacional sem servidor) ou recursos computacionais gerenciados pelo usuário (ou seja, um warehouse virtual).

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 DAG em andamento).

A suspensão de uma tarefa autônoma reinicia sua contagem de execuções de tarefas falhadas. Suspender uma tarefa DAG raiz reinicia a contagem para cada tarefa no DAG.

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

Especifica 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)