Gerenciamento de listagens organizacionais¶

É possível alterar uma listagem para adicionar, modificar ou remover as configurações da listagem organizacional, como título, ULL, contas ou funções de destino, preenchimento automático e muito mais.

Visualize as listagens de organizações disponíveis¶

Faça login no Snowsight.
No menu de navegação, selecione Catalog » Internal Marketplace.
Navegue pelos produtos de dados disponíveis ou use a barra de pesquisa para encontrar uma listagem específica.

Use SHOW AVAILABLE LISTINGS para encontrar listagens em sua organização que estejam disponíveis para você.

SHOW AVAILABLE LISTINGS
  IS_ORGANIZATION = TRUE;

Use SHOW LISTINGS para encontrar listagens nas quais você tem direito a USAGE, MODIFY ou OWNERSHIP.

SHOW LISTINGS;

Edição de uma listagem organizacional¶

Nota

Para evitar sobrescrever as configurações existentes de uma listagem organizacional, é necessário incluir o manifesto existente (manifest_yaml) ao fazer alterações. Use DESCRIBE LISTING para visualizar as configurações atuais.

Você não pode alterar o localizador universal de listagem (ULL) ou remover o produto de dados após a publicação da listagem.

Abra a listagem:
1. Faça login no Snowsight.
2. No menu de navegação, selecione Data sharing » Internal sharing.
3. Na guia Listings, selecione a listagem que você deseja editar.
  - Para refinar a pesquisa, selecione Status e escolha um status, como Draft ou Live.
  - É possível classificar o conjunto de resultados por qualquer coluna.
Edite a listagem:
1. Para editar o título da listagem, selecione o título. A caixa de diálogo Edit listing title aparece.
2. Para editar outros metadados na página de listagem, selecione o botão Edit próximo ao item que você deseja alterar.
3. Para editar as informações do produto de dados, selecione o ícone Data Product. É possível alterar a descrição do produto de dados ou alterar as seleções de tabela ou exibição.

No exemplo a seguir, o destino da organização e os locais de uma listagem organizacional nomeada my-org-listing1 são alterados. A instrução ALTER inclui o manifesto de listagem existente, capturado com o comando DESCRIBE LISTING.

Nota

Você deve ter o privilégio OWNERSHIP ou ter recebido o privilégio MODIFY na listagem para alterá-la. Você pode conceder privilégios de modificação a outras funções usando o seguinte comando:

grant modify on data exchange listing <listing_name> to role <role_name>

USE ROLE <organizational_listing_role>;

ALTER LISTING my-org-listing1
AS
$$
title: "My title"
description: "One region, all accounts"
organization_profile: INTERNAL
organization_targets:
  access:
  - account: "<account_name>"
    roles:
    - "<role>"
locations:
  access_regions:
  - name: "PUBLIC.<snowflake_region>"
$$;

Este manifesto de exemplo tem como alvo todas as contas em uma região do Snowflake.

title: "My title"
description: "One region, all accounts"
organization_profile: INTERNAL
organization_targets:
  access:
  - account: "<account_name>"
    roles:
    - "<role>"
locations:
  access_regions:
  - name: "PUBLIC.<snowflake_region>"

Este manifesto de exemplo visa duas contas, com duas funções cada, em uma região do Snowflake.

title: "My title"
description: "One region, two accounts, four roles"
organization_profile: INTERNAL
organization_targets:
  access:
  - account: "<account_name>"
    roles:
    - "<role>"
    - "<role>"
  - account: "<account_name>"
    roles:
    - "<role>"
    - "<role>"
locations:
  access_regions:
  - name: "PUBLIC.<snowflake_region>"

Este manifesto de exemplo tem como alvo todas as contas em três regiões do Snowflake.

title : 'My title'
description: "Three region, all accounts"
organization_profile: INTERNAL
organization_targets:
  access:
  - all_accounts : true
locations:
  access_regions:
  - names:
  "PUBLIC.<snowflake_region>"
  "PUBLIC.<snowflake_region>"
  "PUBLIC.<snowflake_region>"
auto_fulfillment:
  refresh_type: "SUB_DATABASE"
  refresh_schedule: "10 MINUTE"

Este manifesto de exemplo visa todas as contas em todas as regiões.

title : "My title"
description: "Three region, all accounts"
organization_profile: INTERNAL
organization_targets:
  access:
  - all_accounts : true
locations:
  access_regions:
  - names: "ALL"
auto_fulfillment:
  refresh_type: "SUB_DATABASE"
  refresh_schedule: "10 MINUTE"

Para obter uma lista completa de todos os campos e valores de uma listagem de organizações, consulte Referência do manifesto da listagem da organização.

Remoção de uma listagem do marketplace interno¶

Para remover uma listagem do marketplace interno, é necessário alterar seu status.

Faça login no Snowsight.
No menu de navegação, selecione Data sharing » Internal sharing.
Na guia Listings, selecione a listagem que você deseja remover de Internal Marketplace.
Selecione o bloco de listagem para abrir a página de listagem.
Para cancelar a publicação da listagem, selecione » Unpublish.

ALTER LISTING <organizational_listing_name> UNPUBLISH;

Como excluir uma listagem¶

É necessário cancelar a publicação de uma listagem para que ela possa ser excluída.

Faça login no Snowsight.
No menu de navegação, selecione Data sharing » Internal sharing.
Na guia Listings, selecione a listagem não publicada que você deseja excluir.
Selecione o bloco de listagem para abrir a página de listagem.
Para excluir uma listagem, selecione o ícone ⋮. Na lista que aparece, selecione Delete.

Para excluir uma listagem, execute o seguinte comando:

DROP LISTING <organizational_listing_name>;