Criação de uma listagem organizacional¶
Crie uma listagem organizacional para compartilhar produtos de dados com segurança em sua organização. Antes de criar uma listagem organizacional, você deve analisar os pré-requisitos, as limitações conhecidas e as considerações.
Pré-requisitos¶
Sua organização tem uma função ORGADMIN. (Contas de organização é opcional.)
Limitações conhecidas¶
Este recurso não está disponível em regiões governamentais.
É necessário usar a API para atingir regiões específicas.
Produtos de dados compatíveis: Snowflake Native App Framework e ações.
As listagens organizacionais que contêm um Snowflake Native App não oferecem suporte a funções de destino para acesso ou descoberta.
Os recursos a seguir não são compatíveis com o uso de listagens organizacionais:
Análise do Provider Studio.
Contas de leitor.
Considerações¶
Antes de visar uma organização inteira, verifique se há locatários externos. Ajuste as contas de destino dos produtos de dados antes de adicioná-los a uma listagem organizacional, a menos que você pretenda compartilhá-los com locatários externos.
Cada ação pode ser anexada a uma listagem.
Cada Native App pode ser anexado a uma ou mais listagens.
Para alterações na organização (como fusões) com contas que contenham listagens de organizações, entre em contato com o suporte Snowflake.
Requisitos de controle de acesso¶
Use as informações fornecidas aqui para determinar as funções e os privilégios específicos que é necessário ter para executar os comandos SQL da listagem organizacional.
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.
Atribua privilégios de listagem organizacional¶
Para criar uma listagem organizacional, uma função deve ter os privilégios necessários para criar um compartilhamento, conforme mostrado em Criação e gerenciamento de compartilhamento, bem como os privilégios necessários para criar uma listagem organizacional a partir dele, conforme mostrado em Privilégios para criar uma listagem organizacional usando o compartilhamento.
Privilégios para alterar uma listagem organizacional¶
Um dos privilégios a seguir é necessário para alterar uma listagem.
Função |
Notas |
---|---|
OWNERSHIP |
Pode executar o comando |
MODIFY com opção de concessão |
Pode executar o comando grant modify on data exchange listing <listing_name> to role <role_name>
|
Como consumir ou consultar uma listagem organizacional¶
Para consumir diretamente uma listagem organizacional, você pode fazer referência ao localizador universal de listagem (ULL) sem nenhum privilégio adicional. Se precisar montar a listagem, serão necessários os seguintes privilégios:
Privilégio |
Objeto |
Notas |
---|---|---|
IMPORT ORGANIZATION LISTING |
ACCOUNT |
Para importar uma listagem organizacional. |
Banco de dados CREATE |
ACCOUNT |
Para criar um banco de dados e montar os objetos de listagem. |
Gerenciar as configurações de preenchimento automático de listagem¶
Antes de gerenciar as configurações de preenchimento automático para a listagem da organização, certifique-se de ter as funções necessárias para gerenciar o preenchimento automático da listagem. Para obter mais informações, consulte os privilégios necessários de preenchimento automático.
A função usada para executar essa operação deve ter, no mínimo, os seguintes privilégios:
Privilégio |
Objeto |
Notas |
---|---|---|
MANAGE LISTING AUTO FULFILLMENT |
ACCOUNT |
Para definir as configurações de preenchimento automático. |
Crie uma listagem organizacional no Snowsight ou SQL¶
Create an organizational listing.
Sign in to Snowsight.
Select Data Products » Provider Studio in the left-side navigation menu.
Click + Create Listing » Internal Marketplace.
Click + Data Product.
In the + Data Product dialog, click + Select.
Navigate to a data product such as a table, a view or other data product.
Alternatively, search for and choose a data product to share.
Select Done when complete.
Select Save.
Specify who can access the listing (the target accounts, roles, and regions).
Click + Access Control. The Access and discovery dialog displays.
In the Grant access section, enter values for the following:
Field
Description
Who can access this data product?
Select one of:
Entire organization Anyone in the organization can access the listing.
Selected accounts and roles Only selected accounts and roles can access.
No accounts or roles are pre-approved (Default) Data product will only be available by request.
Accounts
If Select accounts and roles is selected, select one or more accounts.
Click + Add another account to add second and subsequent accounts.
Selected user roles
If Selected roles is selected, enter one or more roles to grant access.
In the Allow discovery section, enter values for the following:
Field
Description
Who else can discover the listing and request access?
Select one of:
Entire organization (Default) Anyone in the organization can discover listing and request access.
Selected accounts and roles Only selected accounts and roles can discover listing and request access.
Not discoverable by users without access Only users with access can discover this listing.
Accounts
If Select accounts and roles is selected, select one or more accounts.
Click + Add another account to add second and subsequent accounts.
Selected user roles
If Selected roles is selected, enter one or more roles to grant access.
In the Request approval section, enter the email address of the request approver or link to the internal ticketing system.
Forneça um título e o localizador universal de listagem (ULL).
A alteração do título de uma listagem é opcional, mas recomendada. Para obter mais informações, consulte localizador universal de listagem.
Selecione Untitled Listing.
Para Listing title, digite um título descritivo para seu produto de dados.
Selecione Save ou Cancel.
Complete a listagem.
Insira informações adicionais sobre a página de listagem para orientar os consumidores, como descrição, dicionário de dados, exemplos de uso e muito mais.
Observe que Support Contact é necessário
Clique em Publish para disponibilizar a listagem no Internal Marketplace. Se você sair sem publicar, a listagem será salva como rascunho, pronta para revisão ou adição de metadados descritivos.
Crie uma listagem organizacional a partir do compartilhamento com os atributos necessários incluídos em YAML (inseridos entre delimitadores $$).
Esta parte do manifesto YAML especifica as contas que poderão usar a listagem organizacional:
organization_targets:
access:
Este exemplo cria uma listagem usando as configurações necessárias no manifesto YAML. Ele visa uma função em uma conta em uma região e inclui contatos de suporte e aprovação:
Nota
support_contact
é obrigatório. approver_contact
é obrigatório se for fornecido um destino discovery
.
USE ROLE <organizational_listing_role>;
CREATE ORGANIZATION LISTING <organization_listing_name>
SHARE <share_name> AS
$$
title: "My title"
description: "One region, all accounts"
organization_profile: "INTERNAL"
organization_targets:
discovery:
- account: "<account_name>"
roles:
- "<role>"
access:
- account: "<account_name>"
roles:
- "<role>"
support_contact: "support@somedomain.com"
approver_contact: "approver@somedomain.com"
locations:
access_regions:
- name: "PUBLIC.<snowflake_region>"
$$;
Para obter uma lista completa de todos os campos e valores de uma listagem organizacional, consulte Referência do manifesto da listagem da organização. Para exemplos adicionais, consulte Definição de quem pode descobrir e acessar uma listagem organizacional.