Categorias:: Funções do sistema (Informações do sistema)

SYSTEM$DESC_ICEBERG_ACCESS_IDENTITY¶

Retorna informações sobre a entidade de serviço do Snowflake para um provedor de nuvem externo especificado em uma conta.

Consulte também:: Configuração da replicação para tabelas Apache Iceberg™ gerenciadas pelo Snowflake

Sintaxe¶

SYSTEM$DESC_ICEBERG_ACCESS_IDENTITY(
  '<cloud_storage_provider>' [ , '<account_name>' ] )

Copy

Argumentos exigidos¶

'cloud_storage_provider'

Especifica o provedor de nuvem para o qual se deseja recuperar as informações da entidade de serviço. Você pode especificar um dos seguintes valores para esse argumento:

'S3'
'GCS'
'AZURE'

Argumentos opcionais¶

'account_name'

Opcionalmente, especifica o nome da conta Snowflake para a qual você deseja recuperar as informações da entidade de serviço. Se especificado, você deve usar o valor na coluna account_name retornada pelo comando SHOW REPLICATION ACCOUNTS.

Se não for especificado, a função retornará informações para a conta atual.

Retornos¶

A função retorna um objeto JSON contendo os seguintes pares nome/valor:

{
  "STORAGE_PROVIDER":"S3",
  "STORAGE_AWS_IAM_USER_ARN":"<iam_user_arn>"
}

Copy

Onde:

STORAGE_PROVIDER
O provedor de armazenamento em nuvem.

STORAGE_AWS_IAM_USER_ARN
O ARN para o usuário do AWS IAM que foi criado automaticamente para sua conta Snowflake.

GCS

{
  "STORAGE_PROVIDER":"GCS",
  "STORAGE_GCP_SERVICE_ACCOUNT":"<service_account_identifier>"
}

Copy

Onde:

STORAGE_PROVIDER
O provedor de armazenamento em nuvem.

STORAGE_GCP_SERVICE_ACCOUNT
O ID para a conta de serviço do GCS que foi criada automaticamente para sua conta Snowflake.

AZURE

{
  "STORAGE_PROVIDER":"AZURE",
  "AZURE_MULTI_TENANT_APP_NAME":"<client_app_name>",
  "AZURE_CONSENT_URL_TEMPLATE":"https://login.microsoftonline.com/<your_tenant_id>/oauth2/authorize?client_id=..."
}

Copy

Onde:

STORAGE_PROVIDER
O provedor de armazenamento em nuvem.

AZURE_MULTI_TENANT_APP_NAME
Nome do aplicativo cliente do Snowflake criado para sua conta Snowflake.

AZURE_CONSENT_URL_TEMPLATE
URL do modelo para a página de solicitação de permissões da Microsoft. Você deve substituir your_tenant_id pelo ID do seu locatário ao qual a localização de armazenamento pertence.

Para encontrar sua ID de locatário, entre no portal Azure e clique em Azure Active Directory » Properties. A ID do locatário é exibida no campo Tenant ID.

Notas de uso¶

Só retorna resultados para administradores de conta (usuários com a função ACCOUNTADMIN).

Exemplos¶

Recuperar a entidade de serviço para o Azure:

SELECT SYSTEM$DESC_ICEBERG_ACCESS_IDENTITY('AZURE', 'MY_TARGET_SNOWFLAKE_ACCOUNT');

Copy