Gerenciamento de listagens de dados¶
Após tornar-se um provedor de dados aprovado em uma troca de dados, você pode começar a adicionar suas listagens de dados.
Neste tópico:
Criação de uma nova listagem de dados¶
Considerações para a criação de uma listagem¶
Nota
Estas considerações também se aplicam à criação de uma listagem em uma região remota.
Como os dados são compartilhados entre diferentes contas, os consumidores de dados devem poder usar objetos de dados compartilhados sem usar identificadores delimitados por aspas duplas (consulte Requisitos para identificadores). Como resultado, os identificadores de objetos para tabelas, colunas e nomes de compartilhamento precisam estar em maiúsculas e usar somente caracteres alfanuméricos.
Para garantir que seus dados confidenciais em um banco de dados compartilhado não sejam expostos aos usuários em contas de consumidor, consulte Uso de objetos seguros para controlar o acesso aos dados.
Os compartilhamentos que atualmente são compartilhados com uma conta de consumidor (ou seja, por um compartilhamento direto) podem ser adicionados a uma listagem. Os consumidores precisam aceitar os termos da listagem em uma interface da Web do Data Exchange para poderem criar um banco de dados a partir do compartilhamento.
Somente a função que criou o compartilhamento pode anexar o compartilhamento a uma listagem.
Um compartilhamento só pode ser anexado a uma única listagem. Se um compartilhamento já tiver sido anexado a uma listagem, não pode ser anexado a outra listagem, mesmo que a listagem tenha sido excluída.
Antes que uma listagem gratuita nova ou modificada possa ser publicada, todas as consultas de exemplo são autovalidadas para garantir que os objetos referenciados sejam adicionados ao compartilhamento e que as consultas possam ser executadas com sucesso.
Os dados devem ser legalmente compartilháveis (ou seja, o provedor deve ser proprietário dos dados ou ter o direito de compartilhá-los).
Nota
Na medida em que quaisquer dados em sua listagem ou conjunto de dados sejam regidos por quaisquer leis ou obrigações contratuais, você deve assegurar-se de que tem os direitos legais e contratuais de compartilhar tais dados. Por exemplo, você só pode compartilhar informações de saúde protegidas (PHI) através de um compartilhamento de dados personalizado e, para isso, você precisa: (1) ter assinado um contrato de associação comercial (BAA) com o Snowflake e o Consumidor que recebe o PHI e; (2) garantir que o Consumidor também tenha assinado um BAA com a Snowflake. Além disso, embora você possa compartilhar dados pessoais por meio de um compartilhamento de dados, para fazê-lo, você deve ter os direitos legais e contratuais aplicáveis se os dados não estiverem disponíveis publicamente.
Considerações para a criação de uma listagem em uma região remota e para replicação de dados¶
Quando você publica uma listagem, os consumidores veem sua listagem em todas as regiões selecionadas.
Enquanto as listagens são automaticamente replicadas, os dados não são.
Para listagens gratuitas, você deve replicar os dados para cada uma das regiões selecionadas antes de publicar a listagem.
Para listagens personalizadas, você pode replicar dados a pedido do consumidor.
Certifique-se de alocar tempo para configurar a replicação e compreender os custos envolvidos.
Para compartilhar dados em uma região, você deve ter uma conta naquela região para poder replicar os dados. Se você tem mais de uma conta, todas as contas devem pertencer à mesma organização.
Quando você publica uma listagem em uma região remota, você pode permitir que todas as contas em sua organização atendam aos pedidos de listagem ou adicionar explicitamente contas individuais como provedores. Somente o proprietário da listagem pode especificar quem pode atender aos pedidos da listagem.
O compartilhamento de dados entre regiões utiliza a funcionalidade de replicação de dados do Snowflake; para mais informações, consulte Compartilhamento de dados de forma segura entre regiões e plataformas de nuvem.
Você não precisa replicar os dados para cada região até que um consumidor os solicite.
Para listagens gratuitas, você tem a opção de pré-associar um compartilhamento à listagem em uma região remota. Isto permitirá que os consumidores obtenham o compartilhamento instantaneamente, sem enviar um pedido.
Para ver uma lista de compartilhamentos anexados a uma listagem em uma região remota, você deve entrar na conta remota da qual anexou o compartilhamento à listagem.
Criação e publicação de uma listagem de dados¶
Para criar uma listagem de dados gratuita ou personalizada:
No Snowsight, navegue até Data » Private Sharing.
Clique na lista suspensa Share Data e selecione uma troca de dados.
Na caixa de diálogo New Listing, digite o título da listagem como ele aparece para os consumidores e selecione o tipo de listagem. Para obter mais informações sobre o tipo de listagem, consulte Tipos de listagens.
Complete cada uma das seções para a nova listagem. Você pode salvar o rascunho a qualquer momento para terminá-lo mais tarde. Para obter uma descrição de cada seção e dos campos relacionados, consulte Referência das capacidades das listagens.
No caso de uma listagem gratuita, para associar um compartilhamento à listagem, ao editar a seção Data:
Nota
Até que uma listagem seja publicada, ela só pode ser associada com um compartilhamento na conta local/primária. Após a publicação da listagem, ela pode ser associada a um compartilhamento em regiões adicionais que você tenha selecionado.
Clique em Select Data.
Se existir um compartilhamento seguro, navegue até o compartilhamento e selecione-o. Se um compartilhamento não existir, navegue até o banco de dados desejado e selecione os objetos do banco de dados que você deseja adicionar ao compartilhamento.
Nota
Se você não vê um compartilhamento, ele já está anexado a outra listagem, ou já foi previamente compartilhado com consumidores.
Clique em Done.
(Opcional) Você pode mudar o nome padrão para o compartilhamento seguro.
Clique em Save.
Uma vez concluídas todas as seções, clique em Publish para publicar a listagem das regiões selecionadas.
O botão Publish não é ativado se:
Qualquer uma das consultas SQL de exemplo fornecidas falharem na validação. Para obter mais informações, consulte Campos de listagem de dados.
Você não é o proprietário do compartilhamento.
Campos de listagem de dados¶
A tabela a seguir descreve os parâmetros necessários para criar e configurar uma listagem de dados no Data Exchange.
Seção |
Nome do campo |
Descrição |
Exemplo |
|---|---|---|---|
Basic Information |
Listing Type |
Consulte Tipos de listagens. |
Valores disponíveis: Gratuito, Personalizado |
Profile |
O nome do perfil do provedor que possui o compartilhamento. Você precisa criar um perfil de provedor antes de poder publicar uma listagem. |
||
Title |
Título da listagem de dados. O título não pode exceder 110 caracteres. |
Historical Weather by Postcode. |
|
Subtitle |
Subtítulo da listagem de dados. O subtítulo não pode exceder 110 caracteres. Título e subtítulo não devem ser redundantes. |
Historical Weather Data by Location. |
|
Data Update Frequency |
Com que frequência os dados são atualizados. |
Valores disponíveis: Near real-time, Daily, Weekly, Monthly, Quarterly, Annually, Never (Static Data). |
|
Category |
As listagens de dados são categorizadas para fácil descoberta. |
||
Terms of Service |
Um link para os Termos de Serviço do provedor, hospedados no site do provedor. Os consumidores aceitam os termos antes de poderem acessar os dados. Os termos de serviço são obrigatórios para listagens gratuitas e opcionais para listagens personalizadas. |
|
|
Details |
Descrição |
Descrição do conjunto de dados compartilhado. A descrição deve incluir: . (a) Escala dos dados . (b) Descrição das tabelas/exibições . (c) Se o conjunto de dados é uma amostra . (d) Onde encontrar dicionários de dados. |
ACME é o provedor número um de avisos meteorológicos personalizados e precisos para grandes empresas, bem como uma fonte de informações vitais para previsões meteorológicas, dados e serviços de consultoria meteorológica em todo o mundo. Estes dados são dados climáticos históricos para códigos postais dos EUA que podem ser usados para melhorar ainda mais seus dados existentes para fornecer uma análise mais profunda. |
Link to Documentation |
Um link para uma página no site do provedor com documentação mais detalhada. A documentação deve ser clara e fazer referência aos objetos do esquema corretos presentes no compartilhamento do Snowflake. Não pode ser apenas uma documentação padrão. |
|
|
Data |
Database Objects or Secure Share |
Selecione os dados que você deseja compartilhar. Esta seção está disponível apenas para listagens de dados gratuitas. |
|
Business Needs |
Business Need |
As listagens de dados são agrupadas por necessidades comerciais para fácil descoberta. . - Você pode selecionar até seis necessidades comerciais para sua listagem. Se você não vê uma necessidade comercial relevante na lista suspensa, pode criar uma necessidade personalizada. . - Os consumidores podem facilmente descobrir listagens baseadas nas necessidades comerciais disponíveis na lista suspensa. Entretanto, as necessidades comerciais personalizadas que você acrescenta não estão incluídas e só são visíveis nos detalhes de sua listagem. |
|
Descrição |
Descrição de como seus dados ou o serviço de dados atende a necessidades comercial. |
||
Sample SQL Query |
Title |
Título descritivo da consulta para ajudar os consumidores a entender os dados. Você pode acrescentar mais de um exemplo. |
|
Description (Optional) |
Descrição do exemplo com instruções adicionais; por exemplo, nome do esquema, tabelas de amostra, campos, casos de uso. |
||
SQL Query |
Teste as consultas de exemplo no banco de dados que você utiliza para criar o compartilhamento. O Snowflake valida automaticamente as consultas para garantir que todos os objetos referenciados sejam adicionados ao compartilhamento e as consultas sejam executadas com sucesso. Se a validação falhar, uma mensagem de erro com um motivo é exibida. Você pode ver um sinal de exclamação ao lado de cada consulta que falhou. |
||
Region Availability |
All available regions ou Specific Regions |
Regiões onde sua listagem será visível. Você precisará replicar os dados para estas regiões. A lista de regiões disponíveis pode ser editada a qualquer momento sem que seja necessário submetê-la novamente à aprovação do administrador. Se você remover uma região que estava anteriormente disponível, os consumidores daquela região não poderão mais ver a listagem. |
Visualização de pedidos de listagens personalizadas¶
Nota
As notificações por e-mail são enviadas aos provedores para notificá-los sobre solicitações de dados. Você pode alterar o e-mail de notificação de solicitação para uma listagem específica na guia Settings.
Para ver os pedidos de listagens personalizadas:
Navegue até Data » Private Sharing.
Clique na guia Requests. Use a lista suspensa de filtragem para ver os pedidos por status.
Aprovação de pedidos de listagem de dados de consumidores em uma região remota¶
Nota
Para listagens personalizadas, os dados não estão automaticamente disponíveis em regiões remotas. O provedor é responsável por replicar os dados para cada uma dessas regiões.
Para listagens gratuitas, você tem a opção de pré-associar um compartilhamento à listagem em uma região remota. Isto permite que os consumidores obtenham o compartilhamento instantaneamente, sem enviar um pedido. Você também pode replicar dados e anexar um compartilhamento a uma listagem após receber um pedido do primeiro consumidor em uma região. Uma vez que a listagem esteja anexada ao compartilhamento, todos os consumidores daquela região podem acessar o compartilhamento instantaneamente.
Você pode especificar se uma lista pode ser preenchida por uma conta ou contas de um provedor selecionado ou por qualquer conta na organização.
Para aprovar um pedido de listagem de dados apresentado por um consumidor:
Nota
Se o consumidor estiver em uma região diferente, antes de anexar um compartilhamento, você deve configurar a replicação dos dados para a conta em cada região remota. Para obter mais informações, consulte Compartilhamento de dados de forma segura entre regiões e plataformas de nuvem.
Navegue até Data » Private Sharing.
Clique na guia Requests.
Clique em Review ao lado do nome da listagem.
Na seção Associate Secure Share, selecione uma conta onde você deseja criar o compartilhamento.
Selecione a função que possui o compartilhamento e os objetos do banco de dados compartilhado (ou tem os privilégios necessários para os objetos do banco de dados para poder adicioná-los a um compartilhamento).
Clique em Select Data.
Se existir um compartilhamento seguro, navegue até o compartilhamento e selecione-o. Se um compartilhamento não existir, navegue até o banco de dados desejado e selecione os objetos do banco de dados que você deseja adicionar ao compartilhamento.
Nota
Se você não vê um compartilhamento, ele já está anexado a outra listagem, ou já foi previamente compartilhado com consumidores.
Clique em Done.
(Opcional) Você pode mudar o nome padrão para o compartilhamento seguro.
Clique em Fullfill Request.
Dica
Se você receber um erro ao atender uma solicitação para uma região remota, considere o seguinte:
A conta remota foi adicionada ao Marketplace como provedor?
A conta remota faz parte da mesma organização que a conta da qual você publicou a listagem?
Você criou um novo compartilhamento usando a função ACCOUNTADMIN?
Você adicionou outros consumidores ao compartilhamento que está tentando anexar?
Visualização de pedidos de listagem atendidos¶
Os provedores que atendem a pedidos de listagens gratuitas ou personalizadas usando o Snowsight podem visualizar registros de consumidores adicionados ao compartilhamento navegando para Data » Private Sharing e selecionando a guia Shared by My Account.
Estes registros também estão disponíveis no Exibição QUERY_HISTORY.
Gerenciamento das listagens de dados existentes¶
Edição de uma listagem de dados¶
Quando você publica uma nova versão da listagem, ela substitui a listagem publicada anteriormente. Se você remover uma região que estava anteriormente disponível, os consumidores dessa região não terão mais acesso ao conjunto de dados compartilhados.
Para editar uma listagem de dados:
Faça login no Snowsight como um ACCOUNTADMIN.
Na barra de navegação à esquerda, clique em Data » Private Sharing » Shared by My Account.
Clique no nome da listagem que você deseja atualizar.
Ao lado do título da listagem, clique em New Draft.
Clique em Edit para a seção que você deseja atualizar.
Clique em Publish.
Cancelamento da publicação de uma listagem de dados¶
Ao publicar uma listagem de dados, os consumidores existentes ainda podem acessar o compartilhamento de dados, a menos que você os remova do compartilhamento. Os novos consumidores não podem vê-lo.
Para cancelar a publicação de uma listagem de dados:
Faça login no Data Exchange usando Snowsight como um administrador de conta.
Na barra de navegação à esquerda, clique em Data » Private Sharing » Shared by My Account.
Clique no nome da listagem cuja publicação você deseja cancelar.
No canto superior direito, a partir da lista suspensa Live, selecione Unpublish.
Republicação de uma listagem de dados¶
Para republicar uma listagem de dados:
Faça login no Data Exchange usando Snowsight como um administrador de conta.
Na barra de navegação à esquerda, clique em Data » Private Sharing » Shared by My Account.
Clique no nome da listagem que você deseja republicar.
No canto superior direito, na lista suspensa, selecione Re-publish.
Clique em Re-publish para republicar a listagem.