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:

  1. No Snowsight, navegue até Data Products » Private Sharing.

  2. Selecione a lista suspensa Share Data e selecione uma troca de dados.

  3. 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.

  4. 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.

    1. Selecione Select Data.

    2. 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.

    3. Selecione Done.

    4. (Opcional) Você pode mudar o nome padrão para o compartilhamento seguro.

    5. Selecione Save.

  5. Uma vez concluídas todas as seções, selecione 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.

https://www.example.com/en/legal

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.

https://developer.example.com

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:

  1. Navegue até Data Products » Private Sharing.

  2. Selecione a 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.

  1. Navegue até Data Products » Private Sharing.

  2. Selecione a guia Requests.

  3. Selecione Review ao lado do nome da listagem.

  4. Na seção Associate Secure Share, selecione uma conta onde você deseja criar o compartilhamento.

  5. 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).

  6. Selecione Select Data.

  7. 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.

  8. Selecione Done.

  9. (Opcional) Você pode mudar o nome padrão para o compartilhamento seguro.

  10. Selecione 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 Products » 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:

  1. Entre no Snowsight como um ACCOUNTADMIN.

  2. No menu de navegação, clique em Data Products » Private Sharing » Shared by My Account.

  3. Clique no nome da listagem que você deseja atualizar.

  4. Ao lado do título da listagem, clique em New Draft.

  5. Clique em Edit para a seção que você deseja atualizar.

  6. 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:

  1. Entre no Data Exchange usando Snowsight como um administrador de conta.

  2. No menu de navegação, selecione Data Products » Private Sharing » Shared by My Account.

  3. Selecione o nome da listagem cuja publicação você deseja cancelar.

  4. 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:

  1. Entre no Data Exchange usando Snowsight como um administrador de conta.

  2. No menu de navegação, selecione Data Products » Private Sharing » Shared by My Account.

  3. Selecione o nome da listagem cuja publicação você deseja repetir.

  4. No canto superior direito, na lista suspensa, selecione Re-publish.

  5. Selecione Re-publish para republicar a listagem.

Atualização de um compartilhamento de dados

Você pode atualizar um compartilhamento de dados usando Classic Console. Tenha em mente que cada vez que você modificar uma listagem de dados, deve notificar os consumidores para garantir que você não interrompa os processos deles. Exemplos de alterações interruptivas incluem:

  • Adicionar/remover uma coluna.

  • Renomear objetos.

  • Remover objetos.