DESCRIBE SNAPSHOT

Nota

Esta operação não é atualmente coberta pelo nível de serviço definido na Política de suporte e Acordo de nível de serviço da Snowflake.

Descreve as propriedades de um instantâneo.

DESCRIBE pode ser abreviado como DESC.

Consulte também:

CREATE SNAPSHOT , ALTER SNAPSHOT, DROP SNAPSHOT, SHOW SNAPSHOTS

Sintaxe

{ DESC | DESCRIBE } SNAPSHOT <name>
Copy

Parâmetros

name

Especifica o identificador do instantâneo a ser descrito.

Se o identificador contiver espaços ou caracteres especiais, toda a cadeia de caracteres deverá ser delimitada por aspas duplas. Os identificadores delimitados por aspas duplas também diferenciam letras maiúsculas de minúsculas.

Para obter mais informações, consulte Requisitos para identificadores.

Saída

A saída do comando inclui as seguintes colunas, que descrevem as propriedades e metadados do objeto:

Coluna

Descrição

name

Nome do instantâneo.

state

Um dos seguintes valores, que indica o status atual do instantâneo:

  • INITIALIZED: A criação do instantâneo está em andamento.

  • CREATED: O instantâneo é criado e pode ser usado para criar um volume.

  • ERROR: Falha na criação do instantâneo.

database_name

Banco de dados no qual o instantâneo é criado.

schema_name

Esquema no qual o instantâneo é criado.

service_name

Nome do serviço totalmente qualificado a partir do qual o instantâneo é criado.

volume_name

Volume da instância de serviço especificada para a qual o instantâneo é criado.

instance

ID da instância do serviço.

size

Tamanho (em GB) do instantâneo.

comment

Comentário geral sobre o instantâneo.

owner

Função proprietária do instantâneo.

owner_role_type

O tipo de função que possui o objeto, seja ROLE ou DATABASE_ROLE.

created_on

Data e hora em que o instantâneo foi criado.

Requisitos de controle de acesso

A função usada para executar essa operação deve ter, no mínimo, os seguintes privilégios:

Privilégio

Objeto

Notas

OWNERSHIP ou USAGE

Instantâneo

OWNERSHIP is a special privilege on an object that is automatically granted to the role that created the object, but can also be transferred using the GRANT OWNERSHIP command to a different role by the owning role (or any role with the MANAGE GRANTS privilege).

O privilégio USAGE no banco de dados e no esquema pai é necessário para executar operações em qualquer objeto de um esquema.

Para instruções sobre como criar uma função personalizada com um conjunto específico de privilégios, consulte Criação de funções personalizadas.

Para informações gerais sobre concessões de funções e privilégios para executar ações de SQL em objetos protegíveis, consulte Visão geral do controle de acesso.

Notas de uso

  • Para pós-processar a saída deste comando, você pode usar a função RESULT_SCAN, que trata a saída como uma tabela que pode ser consultada.

Exemplos

O exemplo a seguir descreve o instantâneo denominado my_snapshot:

DESC SNAPSHOT my_snapshot;
Copy

Saída:

+-------------+---------+---------------+-------------+------------------------------------+-------------+----------+------+-----------------+-----------+-----------------+-------------------------------+-------------------------------+
| name        | state   | database_name | schema_name | service_name                       | volume_name | instance | size | comment         | owner     | owner_role_type | created_on                    | updated_on                    |
|-------------+---------+---------------+-------------+------------------------------------+-------------+----------+------+-----------------+-----------+-----------------+-------------------------------+-------------------------------|
| MY_SNAPSHOT | CREATED | TUTORIAL_DB   | DATA_SCHEMA | TUTORIAL_DB.DATA_SCHEMA.MY_SERVICE | block-vol1  | 0        |   10 | updated comment | TEST_ROLE | ROLE            | 2023-12-13 17:06:04.162 -0800 | 2023-12-13 17:06:56.303 -0800 |
+-------------+---------+---------------+-------------+------------------------------------+-------------+----------+------+-----------------+-----------+-----------------+-------------------------------+-------------------------------+