Configuração de listagens organizacionais

Esta página apresenta configurações para listagens organizacionais no Snowflake. Você encontrará detalhes sobre a segmentação de contas, adição de funções, regiões de acesso e configurações de preenchimento automático.

Definição do localizador universal de listagem ou o nome de listagem

O localizador universal de listagem (ULL) é um identificador exclusivo que representa a listagem e seu produto de dados, tratando-os como um só. O nome da listagem é diferente do título da listagem: várias listagens podem ter o mesmo título, mas cada listagem deve ter um nome de listagem exclusivo ou ULL. O ULL completo é formado por três elementos delimitados pelo símbolo «$». O primeiro elemento é o nome da organização do provedor, o segundo elemento é o perfil de provedor INTERNAL e o terceiro elemento é o nome da listagem. O ULL não pode ser alterado após a publicação da listagem. Embora tenha três partes, o ULL é tratado como um único nome nas consultas. Por exemplo, é possível consultar uma tabela em uma listagem como esta:

SELECT * FROM "ORGDATACLOUD$INTERNAL$MY_LISTING_NAME_123".PUBLIC.TABLE_FROM_LISTING;
Copy

Ao criar uma listagem, dê a ela um nome claro e descritivo. Os consumidores podem encontrar listagens mais rapidamente pelo nome em vez do título, e um nome descritivo é mais fácil de usar em consultas.

Definição de quem pode descobrir e acessar uma listagem organizacional

O público-alvo de suas listagens organizacionais é sempre o mercado interno.

Apesar da restrição de uma listagem interna, você ainda pode controlar quem pode descobrir e acessar a listagem. É possível marcar uma listagem como detectável e acessível individualmente. Ou seja, você pode conseguir descobrir uma listagem, mas não pode acessá-la.

Em geral, é possível especificar o acesso ou a descoberta nos seguintes níveis:

  • Todos em sua conta

  • Contas específicas

  • Contas específicas, mas limitadas por funções específicas

Por exemplo, o elemento access define quem pode acessar uma listagem. Da mesma forma, o elemento discovery define quem pode descobrir uma listagem.

Permita que todas as contas acessem a listagem.

organization_targets:
   access:
   - all_accounts : true
Copy

Permita que contas específicas acessem a listagem.

organization_targets:
   access:
   - account: 'Account1'
   - account: 'Account2'
Copy

Permita que contas específicas acessem a listagem, mas somente para as funções fornecidas.

organization_targets:
   access:
      - account: 'Account1'
         roles: [<role1>, <role2>, <role3>]
Copy

Permita que todas as contas descubram a listagem.

organization_targets:
   discovery:
   - all_accounts : true
Copy

Permita que contas específicas descubram a listagem.

organization_targets:
   discovery:
   - account: 'Account1'
   - account: 'Account2'
Copy

Permita que contas específicas descubram a listagem, mas somente para as funções determinadas.

organization_targets:
   discovery:
      - account: 'Account1'
         roles: [<role1>, <role2>, <role3>]
Copy

De maneira semelhante, as regiões são configuradas com o atributo de acesso regions_attribute:

locations:
  access_regions:
     - name: "ALL"
Copy
locations:
   access_regions:
     - name: "AWS_US_WEST_2"
     - name: "AZURE_CENTRALINDIAUS-EAST"
Copy

Especificação do aprovador e contato de suporte

Opcionalmente, é possível especificar um endereço de e-mail ou um link para o sistema interno de emissão de tíquetes para o aprovador e o contato de suporte.

support_contact: "support@somedomain.com"
approver_contact: "approver@somedomain.com"
Copy

Definição de opções de preenchimento automático para uma listagem organizacional

As listagens organizacionais que têm compartilhamentos de dados e aplicativos anexados usam o preenchimento automático, mas cada uma delas usa métodos diferentes. Por esse motivo, os cronogramas de atualização de cada um são diferentes. Para compartilhamentos, o cronograma de atualização é definido no nível do banco de dados. Para aplicativos, ele é definido no nível da conta.

Se precisar usar o preenchimento automático, é possível defini-lo ao executar CREATE ORGANIZATIONAL LISTING OR ALTER LISTING alterando o atributo auto_fulfillment nos campos de manifesto de listagem.

auto_fulfillment:
   refresh_type: SUB_DATABASE
   refresh_schedule: '10 MINUTE'
Copy