Gerenciamento de tabelas de diretório¶

Sintaxe¶

-- Internal stage
CREATE [ OR REPLACE ] [ TEMPORARY ] STAGE [ IF NOT EXISTS ] <internal_stage_name>
  [ DIRECTORY = ( { ENABLE = TRUE | FALSE } ) ]
  [ ENCRYPTION = (TYPE = 'SNOWFLAKE_FULL' | TYPE = 'SNOWFLAKE_SSE') ]
  [ FILE_FORMAT = ( { FORMAT_NAME = '<file_format_name>' | TYPE = { CSV | JSON | AVRO | ORC | PARQUET | XML } [ formatTypeOptions ] } ) ]
  [ COPY_OPTIONS = ( copyOptions ) ]
  [ COMMENT = '<string_literal>' ]

-- External stage
CREATE [ OR REPLACE ] [ TEMPORARY ] STAGE [ IF NOT EXISTS ] <external_stage_name>
      <cloud_storage_access_settings>
    [ DIRECTORY = ( { ENABLE = TRUE | FALSE } ) ]
    [ FILE_FORMAT = ( { FORMAT_NAME = '<file_format_name>' | TYPE = { CSV | JSON | AVRO | ORC | PARQUET | XML } [ formatTypeOptions ] } ) ]
    [ COPY_OPTIONS = ( copyOptions ) ]
    [ COMMENT = '<string_literal>' ]

Onde:

ENABLE = TRUE | FALSE

Especifica se deve ser adicionada uma tabela de diretório ao estágio. Quando o valor é TRUE, uma tabela de diretório é criada com o estágio.

Padrão: FALSE

[ ENCRYPTION = (TYPE = 'SNOWFLAKE_FULL' | TYPE = 'SNOWFLAKE_SSE') ]

Especifica o tipo de criptografia suportada para todos os arquivos armazenados no estágio.

TYPE = ...

Especifica o tipo de criptografia utilizado. Os valores possíveis são:

• SNOWFLAKE_FULL: criptografia do lado do cliente. Os arquivos são criptografados por um cliente quando ele os carrega no estágio interno usando PUT.

• SNOWFLAKE_SSE: criptografia do lado do servidor. Os arquivos são criptografados quando chegam ao estágio.

  Especifique a criptografia do lado do servidor se você planeja consultar URLs de arquivos pré-assinados para seus arquivos preparados.

  Quando os arquivos em uma estágio são criptografados do lado do cliente, os usuários não podem ler os arquivos preparados sem ter acesso à chave de criptografia.

  Para obter mais informações sobre os estágios internos nomeados apenas com criptografia do lado do servidor, consulte CREATE STAGE.

Padrão: SNOWFLAKE_FULL

Notas de uso¶

• Depois de criar um estágio com uma tabela de diretório, você deve executar ALTER STAGE … REFRESH para atualizar manualmente os metadados da tabela de diretório.

Exemplos¶

Criar um estágio interno chamado mystage que inclua uma tabela de diretório. O estágio faz referência a um formato de arquivo chamado myformat:

CREATE STAGE mystage
  DIRECTORY = (ENABLE = TRUE)
  FILE_FORMAT = myformat;

Copy

Criar um estágio externo chamado mystage que inclua uma tabela de diretório. O estágio faz referência a um bucket ou contêiner chamado load com um caminho de files. O acesso seguro ao local de armazenamento em nuvem é fornecido por meio da integração de armazenamento my_storage_int:

Amazon S3

CREATE STAGE mystage
  URL='s3://load/files/'
  STORAGE_INTEGRATION = my_storage_int
  DIRECTORY = (ENABLE = TRUE);

Google Cloud Storage

CREATE STAGE mystage
  URL='gcs://load/files/'
  STORAGE_INTEGRATION = my_storage_int
  DIRECTORY = (ENABLE = TRUE);

Microsoft Azure

CREATE STAGE mystage
  URL='azure://myaccount.blob.core.windows.net/load/files/'
  STORAGE_INTEGRATION = my_storage_int
  DIRECTORY = (ENABLE = TRUE);

Tabelas de diretório de atualização manual¶

Atualize os metadados em uma tabela de diretório manualmente usando o comando ALTER STAGE.

Por exemplo:

ALTER STAGE mystage REFRESH;

Saída¶

A saída de uma consulta de tabela de diretório pode incluir as seguintes colunas:

Coluna	Tipo de dados	Descrição
RELATIVE_PATH	TEXT	Caminho para os arquivos a serem acessados usando o URL do arquivo.
SIZE	NUMBER	Tamanho do arquivo (em bytes).
LAST_MODIFIED	TIMESTAMP_LTZ	Carimbo de data/hora em que o arquivo foi atualizado pela última vez no estágio.
MD5	HEX	Soma de verificação MD5 para o arquivo.
ETAG	HEX	Cabeçalho ETag para o arquivo.
FILE_URL	TEXT	URL do arquivo hospedado no Snowflake para o arquivo. O URL do arquivo tem o seguinte formato: https://<account_identifier>/api/files/<db_name>.<schema_name>.<stage_name>/<relative_path> Copy Onde: account_identifier Nome do host da conta Snowflake para seu estágio. O nome do host começa com um localizador de conta (fornecido pelo Snowflake) e termina com o domínio Snowflake (snowflakecomputing.com): account_locator.snowflakecomputing.com Para obter mais detalhes, consulte Identificadores de conta. Nota Para contas Business Critical, um segmento privatelink é anexado ao URL logo antes de snowflakecomputing.com (privatelink.snowflakecomputing.com), mesmo se a conectividade privada ao serviço Snowflake são estiver habilitado para sua conta. db_name Nome do banco de dados que contém o estágio em que seus arquivos estão localizados. schema_name Nome do esquema que contém o estágio em que seus arquivos estão localizados. stage_name Nome do estágio em que seus arquivos estão localizados. relative_path Caminho para os arquivos a serem acessados usando o URL do arquivo.

Notas de uso¶

• Se os arquivos baixados de um estágio interno estiverem corrompidos, verifique com o criador do estágio se ENCRYPTION = (TYPE = 'SNOWFLAKE_SSE') está definido para o estágio.

Exemplos¶

Recupere todas as colunas de metadados em uma tabela de diretório para um estágio chamado mystage:

SELECT * FROM DIRECTORY(@mystage);

Retorne os valores da coluna FILE_URL da mesma tabela de diretório. Somente retorne os URLs de arquivo para arquivos com tamanho maior do que 100.000 bytes:

SELECT FILE_URL FROM DIRECTORY(@mystage) WHERE SIZE > 100000;

Retorne os valores da coluna FILE_URL da mesma tabela de diretório. Retorne somente os URLs de arquivo para arquivos com valores separados por vírgula:

SELECT FILE_URL FROM DIRECTORY(@mystage) WHERE RELATIVE_PATH ILIKE '%.csv';