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:

A operação em um objeto de esquema requer pelo menos um privilégio no banco de dados pai e um privilégio no esquema pai.

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;