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

Uma função usada para executar este comando SQL deve ter os seguintes privilégios no mínimo:

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

Observe que operar em qualquer objeto de um esquema também requer o privilégio USAGE no banco de dados e esquema principais.

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 |
+-------------+---------+---------------+-------------+------------------------------------+-------------+----------+------+-----------------+-----------+-----------------+-------------------------------+-------------------------------+
Linguagem: Português