SHOW DATASETS¶

Sintaxe¶

SHOW DATASETS
  [ LIKE '<pattern>' ]
  [ IN { SCHEMA <schema_name> | DATABASE <db_name> | ACCOUNT } ]
  [ STARTS WITH '<name_string>' ]
  [ LIMIT <rows> [ FROM '<name_string>' ] ]

Parâmetros opcionais¶

LIKE pattern

Restringe a lista de conjuntos de dados retornados àqueles que correspondem ao padrão especificado.

IN SCHEMA <schema_name> | DATABASE <db_name> | ACCOUNT

Restringe a lista de conjuntos de dados retornados aos que estão no esquema ou banco de dados especificado em uma conta.

DATABASE db_name

Restringe a lista de conjuntos de dados retornados aos que estão no banco de dados especificado. Se você especificar um banco de dados sem db_name e nenhum banco de dados estiver em uso, a palavra-chave they não terá efeito na saída.

SCHEMA schema_name

Por padrão, retorna registros para o esquema em uso. Você também pode especificar um schema_name.

STARTS WITH name_string

Usa a cadeia de caracteres que você especifica para limitar os conjuntos de dados retornados. Os nomes dos conjuntos de dados retornados têm os mesmos caracteres iniciais que a cadeia de caracteres especificada.

LIMIT rows [ FROM name_string ]

Limita o número de conjuntos de dados retornados ao número especificado de linhas. A cláusula opcional FROM especifica o ponto de partida para os conjuntos de dados retornados.

Requisitos de controle de acesso¶

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

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.

Exemplos¶

O exemplo a seguir mostra dois conjuntos de dados no esquema PUBLIC:

SHOW DATASETS IN SCHEMA PUBLIC LIMIT 2;