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:
Faça login no Snowsight.
No menu de navegação, selecione Data sharing » Provider Studio.
Selecione a guia Listings.
Selecione Shared with » Internal Marketplace.
Para refinar ainda mais sua pesquisa, selecione Status e escolha um status, como Draft ou Live. É possível classificar o conjunto de resultados por qualquer coluna.
Selecione o título da listagem para abrir a página da listagem.
Edite a listagem:
Para editar o título da listagem, selecione o título. A caixa de diálogo Edit listing title aparece.
Para editar outros metadados na página de listagem, selecione o botão Edit próximo ao item que você deseja alterar.
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 » Provider Studio.
Selecione a guia Listings.
Selecione Shared with » Internal Marketplace.
Localize a listagem que deseja remover.
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 » Provider Studio.
Selecione a guia Listings.
Selecione Shared with » Internal Marketplace.
Localize a listagem não publicada que deseja remover.
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>;