SHOW ACCOUNTS

Lista todas as contas em sua organização, excluindo as contas gerenciadas.

Dica

Além do SQL, você também pode usar outras interfaces, como Snowflake REST APIs, Snowflake Python APIs e Snowflake CLI. Consulte Interfaces alternativas.

Consulte também:

SHOW REPLICATION ACCOUNTS, SHOW MANAGED ACCOUNTS

Sintaxe

SHOW ACCOUNTS [ HISTORY ] [ LIKE '<pattern>' ]
Copy

Parâmetros

HISTORY

Opcionalmente inclui contas descartadas que ainda não foram excluídas. A saída de SHOW ACCOUNTS HISTORY inclui colunas adicionais relacionadas a contas descartadas.

Padrão: sem valor (as contas descartadas não estão incluídas na saída)

LIKE 'pattern'

Opcionalmente, filtra a saída do comando pelo nome do objeto. O filtro utiliza correspondência de padrão que não diferencia maiúsculas e minúsculas, com suporte para caracteres curinga SQL (% e _).

Por exemplo, os seguintes padrões retornam os mesmos resultados:

... LIKE '%testing%' ...
... LIKE '%TESTING%' ...

. padrão: sem valor (nenhuma filtragem é aplicada à saída).

Saída

A saída do comando fornece propriedades globais de conta e metadados nas seguintes colunas:

Coluna

Descrição

organization_name

Nome da organização.

account_name

Nome definido pelo usuário que identifica uma conta dentro da organização.

region_group

Grupo de regiões onde a conta está localizada. Observação: esta coluna é exibida apenas para organizações que abrangem vários grupos de regiões.

snowflake_region

Snowflake Region onde a conta está localizada. Uma Snowflake Region é um local distinto dentro de uma região de plataforma em nuvem que é isolada de outras Snowflake Regions. Uma Snowflake Region pode ser multilocatária ou unilocatária (para uma conta Virtual Private Snowflake).

edition

Edição do Snowflake da conta.

account_url

URL da conta Snowflake preferida que inclui os valores de organization_name e account_name.

created_on

Data e hora em que a conta foi criada.

comment

Comentário para a conta.

account_locator

Identificador atribuído pelo sistema da conta.

account_locator_url

Sintaxe do URL da conta Snowflake legada que inclui o region_name e o account_locator.

managed_accounts

Indica quantas contas gerenciadas foram criadas pela conta.

consumption_billing_entity_name

Nome da entidade de faturamento do consumo.

marketplace_consumer_billing_entity_name

Nome da entidade de faturamento do consumidor do Marketplace.

marketplace_provider_billing_entity_name

Nome da entidade de faturamento do provedor do Marketplace.

old_account_url

Se o URL original da conta tiver sido salvo quando a conta foi renomeada, fornece o URL original. Se o URL original da conta tiver sido descartado, o valor será NULL mesmo que a conta tenha sido renomeada.

is_org_admin

Indica se a função ORGADMIN está habilitada em uma conta. Se TRUE, a função está habilitada.

dropped_on [1]

Data e hora em que a conta foi descartada.

scheduled_deletion_time [1]

Data e hora em que a conta está programada para ser excluída permanentemente. As contas são excluídas dentro de uma hora após o horário agendado.

restored_on [1]

Data e hora em que a conta foi restaurada.

account_old_url_saved_on

Se o URL da conta original foi salvo quando a conta foi renomeada, fornece a data e a hora em que o URL da conta original foi salvo.

account_old_url_last_used

Se o URL original da conta tiver sido salvo quando a conta foi renomeada, indica a última vez que a conta foi acessada usando o URL original.

organization_old_url

Se a organização da conta tiver sido alterada de forma a criar um novo URL da conta e o URL original da conta tiver sido salvo, fornece o URL original da conta. Se o URL original da conta tiver sido descartado, o valor será NULL mesmo que a organização tenha sido alterada.

organization_old_url_saved_on

Se a organização da conta foi alterada de forma a criar um novo URL da conta e o URL da conta original foi salvo, fornece a data e a hora em que o URL da conta original foi salvo.

organization_old_url_last_used

Se a organização da conta tiver sido alterada de forma a criar um novo URL de conta e o URL original da conta tiver sido salvo, indica a última vez que a conta foi acessada usando o URL original da conta.

moved_to_organization [1]

Se a conta tiver sido movida para uma organização diferente, forneça o nome dessa organização.

moved_on [1]

Data e hora em que a conta foi movida para uma organização diferente.

organization_URL_expiration_on [1]

Se a organização da conta foi alterada de forma a criar um novo URL da conta e o URL da conta original foi salvo, fornece a data e a hora em que o URL da conta original foi descartado. URLs descartados não podem ser usados para acessar a conta.

is_events_account

Indica se uma conta é uma conta de eventos. Para obter mais informações, consulte Configuração de registro e rastreamento de evento para um aplicativo.

is_organization_account

Indica se uma conta é a conta da organização.

Requisitos de controle de acesso

Quando um administrador da organização executar esse comando, a saída incluirá todas as colunas.

Você também pode usar uma função com um dos seguintes privilégios para executar o comando, mas apenas um subconjunto das colunas é retornada:

  • CREATE LISTING

  • CREATE DATA EXCHANGE LISTING

  • CREATE ORGANIZATION LISTING

Notas de uso

  • O comando não precisa de um warehouse em funcionamento para ser executado.

  • O comando retorna apenas objetos para os quais a função atual do usuário atual recebeu pelo menos um privilégio de acesso.

  • O privilégio de acesso MANAGE GRANTS permite implicitamente que seu titular consulte todos os objetos da conta. Por padrão, somente o administrador de conta (usuários com a função ACCOUNTADMIN) e o administrador de segurança (usuários com a função SECURITYADMIN) têm o privilégio MANAGE GRANTS.

  • Para pós-processar a saída deste comando, você pode usar o operador de canal (->>) ou a função RESULT_SCAN. Ambos os constructos tratam a saída como um conjunto de resultados que você pode consultar.

    Os nomes das colunas de saída para este comando são gerados em minúsculas. Se você consumir um conjunto de resultados deste comando com o operador de canal ou a função RESULT_SCAN, use identificadores entre aspas duplas para os nomes das colunas na consulta para garantir que eles correspondam aos nomes das colunas na saída que foi verificada. Por exemplo, se o nome de uma coluna de saída for type, especifique "type" para o identificador.

  • O comando retorna um máximo de dez mil registros para o tipo de objeto especificado, conforme ditado pelos privilégios de acesso da função usada para executar o comando. Todos os registros acima do limite de dez mil registros não são retornados, mesmo com um filtro aplicado.

    Para visualizar os resultados para os quais existem mais de dez mil registros, consulte a exibição correspondente (se houver) em Snowflake Information Schema.

Exemplos

Mostrar todas as contas cujo nome começa com myaccount:

SHOW ACCOUNTS LIKE 'myaccount%';
Copy

Interfaces alternativas