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¶
Você tem acesso à função ORGADMIN (Contas de organização é opcional).
O administrador de sua organização (ORGADMIN) assinou os termos para listagem.
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.
Os recursos a seguir não são compatíveis com o uso de listagens organizacionais:
Criação personalizada de perfis.
Análise do marketplace.
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 compartilhar 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.
CREATE ORGANIZATION LISTING¶
A função usada para executar essa operação deve ter, no mínimo, os seguintes privilégios:
Privilégio |
Objeto |
Notas |
---|---|---|
CREATE ORGANIZATION LISTING |
ACCOUNT |
Para criar e alterar listagens organizacionais. |
CREATE DATA EXCHANGE LISTING |
ACCOUNT |
Para criar e alterar listagens organizacionais. |
Uma função usada para executar esse comando SQL deve ter pelo menos um dos seguintes privilégios, no mínimo:
Privilégio |
Objeto |
Notas |
---|---|---|
USAGE |
SHARE |
Para anexar o compartilhamento especificado a uma listagem. |
USAGE |
APPLICATION |
Para anexar o Snowflake Native App Framework especificado a uma listagem. |
MANAGE LISTING AUTO FULFILLMENT¶
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. |
Criação de uma listagem organizacional¶
Create an organizational listing.
Sign in to Snowsight.
Select Data Products » Provider Studio in the left-side navigation menu.
Click + 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. Consulte o localizador universal de listagem para obter mais informações.
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 exemplos adicionais, consulte Definição de quem pode descobrir e acessar uma listagem organizacional.