Criação de uma listagem organizacional¶

1. Criar uma listagem organizacional.

   1. Faça login no Snowsight.

   2. Selecione Data Products » Provider Studio no menu de navegação do lado esquerdo.

   3. Selecione + Create Listing » Internal Marketplace.

   4. Selecione + Data Product.

   5. Na caixa de diálogo + Data Product, clique em + Select.

   6. Navegue até um produto de dados, como uma tabela, exibição ou outro produto de dados.

      Como alternativa, pesquise e escolha um produto de dados para compartilhar.

   7. Selecione Done ao concluir.

   8. Selecione Save.

2. Especifique quem pode acessar a listagem (as funções, regiões e contas de destino).

   1. Selecione + Access Control. A caixa de diálogo Access and discovery exibe.

   2. Preencha a seção Grant access:

      Campo	Descrição
      Who can access this data product?	Selecione um dos seguintes: Entire organization: qualquer pessoa na organização pode acessar a listagem. Se Entire organization estiver selecionado e o preenchimento automático entre nuvens estiver ativado em sua conta, você será solicitado a revisar as configurações de atualização do preenchimento automático para a listagem. Selected accounts and roles: somente contas e funções selecionadas podem acessar. No accounts or roles are pre-approved: (padrão) o produto de dados estará disponível somente mediante solicitação.
      Accounts	Se Selected accounts and roles for selecionado, selecione uma ou mais contas. Opcional. Selecione + Add another account para adicionar uma segunda conta e as subsequentes. Por padrão, todas as funções nas contas selecionadas podem acessar a listagem. Selecione Selected roles para conceder acesso apenas a funções específicas de cada conta selecionada.

   3. Preencha a seção Allow discovery:

      Campo	Descrição
      Who else can discover the listing and request access?	Selecione uma das opções: Entire organization: (padrão) qualquer pessoa na organização pode descobrir a listagem e solicitar acesso. Este campo é selecionado e desativado se Entire organization for especificado na seção Grant access. Selected accounts and roles: somente contas e funções selecionadas podem descobrir a listagem e solicitar acesso. Not discoverable by users without access: somente usuários com acesso podem descobrir este anúncio.
      Accounts	Se Select accounts and roles for selecionado, selecione uma ou mais contas. Opcional. Selecione + Add another account para adicionar uma segunda conta e as subsequentes e conceder acesso a funções específicas.
      Selected user roles	Se Selected roles for selecionado, insira uma ou mais funções para conceder acesso.

   4. Se Allow discovery for Selected accounts and roles, selecione Set up request approval flow.

      • Na caixa de diálogo Set up request approval flow, selecione uma das seguintes opções na lista How should the request approval happen?:

        • Manage requests in Snowflake: insira o endereço de e-mail do aprovador da solicitação e, opcionalmente, especifique funções adicionais que podem aprovar solicitações.

        • Manage requests outside of Snowflake: insira um endereço de e-mail para o aprovador da solicitação ou insira um URL que aponte para um sistema interno de tíquetes.

        Nota

        O botão Set up request approval flow não estará disponível se o produto de dados for acessível por toda a organização ou se o produto de dados não for detectável por usuários sem acesso.

3. Forneça um título e revise o localizador uniforme de listagem (ULL) gerado.

   A alteração do título de uma listagem é opcional, mas recomendada. Para obter mais informações, consulte localizador universal de listagem.

   1. Selecione Untitled Listing.

   2. Para Listing title, digite um título descritivo para seu produto de dados.

   3. Selecione Save ou Cancel.

4. Complete a listagem.

   Insira informações adicionais sobre a página da listagem para orientar os consumidores, como descrição, dicionário de dados, exemplos de uso, atributos e muito mais.

   Observe que o Support Contact é obrigatório.

5. Selecione Publish para disponibilizar a listagem em Internal Marketplace.

   Se você sair sem publicar, a listagem será salva como um rascunho, pronta para revisão ou para a 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:

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.