Configuração do preenchimento automático¶

Esta seção descreve como configurar o Preenchimento automático entre nuvens (preenchimento automático) para produtos de dados de compartilhamento seguro e produtos de dados de pacotes de aplicativos. Ela também descreve como configurar o preenchimento automático em nível de objeto para uma listagem.

Você deve adicionar um produto de dados à sua listagem antes de configurar o preenchimento automático. Além disso, as etapas para configurar o preenchimento automático são diferentes dependendo do produto de dados que você oferece e de como você disponibiliza sua listagem.

Configure o preenchimento automático para um produto de dados de compartilhamento seguro compartilhado no Snowflake Marketplace¶

Se seu produto de dados for um compartilhamento seguro publicado no Snowflake Marketplace usando uma listagem, siga as etapas a seguir para configurar o preenchimento automático:

Faça login no Snowsight.
No menu de navegação, selecione Data sharing » Provider Studio » Listings.
Selecione a listagem para a qual você deseja configurar o preenchimento automático.
Selecione Region Availability » Edit.
Para Region availability, escolha a disponibilidade desejada.
- Por padrão, All regions é selecionado. Isso garante a disponibilidade da sua listagem em qualquer região futura adicionada pelo Snowflake.
- Se sua listagem tiver limitações regionais específicas, altere a disponibilidade da região para Custom regions e selecione as regiões nas quais deseja oferecer seu produto de dados. Quando você escolhe regiões personalizadas, sua listagem fica visível em todas as regiões do Snowflake Marketplace atuais, mas os consumidores só podem obter seu produto de dados nas regiões que você especificar. Sua listagem não estará disponível automaticamente em nenhuma nova região.
- Para listagens pagas, Custom regions é selecionado por padrão. Listagens pagas estão disponíveis apenas nas regiões suportadas e quaisquer regiões futuras com suporte adicionadas pelo Snowflake.
Para Fulfillment method, o preenchimento Automatic é a seleção padrão. Com o preenchimento automático entre nuvens, seu produto de dados será preenchido automaticamente em uma região e você incorre em custos somente quando há demanda do consumidor nessa região.

Se não for possível usar o preenchimento automático e a opção estiver disponível, selecione Manual para replicar manualmente o produto de dados. Consulte Replicação manual dos dados para atender a uma solicitação de listagem.
Se você selecionar Automatic para preenchimento automático:
1. Selecione um intervalo de atualização na lista suspensa e, em seguida, insira um valor. Você deve selecionar um intervalo de atualização de pelo menos 8 dias.
2. Se você não tiver um warehouse padrão definido, selecione um warehouse para usar para preenchimento automático.
3. Quando você adiciona um produto de dados à sua listagem, o Snowflake realiza uma verificação de compatibilidade para validar se seu produto de dados pode ser preenchido automaticamente para outras regiões. Se a verificação retornar alguma incompatibilidade, talvez seja necessário atualizar seu produto de dados. Consulte Solução de problemas de preenchimento automático.
4. Selecione Save and Enable Fulfillment.
  
  O preenchimento automático para a listagem agora está ativado, mas o produto de dados anexado à listagem não é preenchido em nenhuma região até que a listagem seja publicada e um consumidor solicite o produto de dados. Consulte Como funciona o preenchimento automático.
Se você optar por preencher manualmente a listagem, selecione Save. Antes de publicar a listagem, você deve replicar os dados para cada uma das regiões disponíveis que você selecionar. Consulte Replicação manual dos dados para atender a uma solicitação de listagem.

Configuração do preenchimento automático para um produto de dados de pacote de aplicativo compartilhado no Snowflake Marketplace¶

Se seu produto de dados for um pacote de aplicativo publicado no Snowflake Marketplace com uma listagem, siga as etapas a seguir para configurar o preenchimento automático:

Faça login no Snowsight.
No menu de navegação, selecione Data sharing » Provider Studio » Listings.
Selecione a listagem para a qual você deseja configurar o preenchimento automático.
Selecione Region Availability » Edit.
Para Region availability, escolha a disponibilidade desejada.
- Por padrão, All regions é selecionado. A escolha de todas as regiões garante a disponibilidade de sua listagem em qualquer região futura adicionada pelo Snowflake.
- Se sua listagem tiver limitações regionais específicas, altere a disponibilidade da região para Custom regions e selecione as regiões nas quais deseja oferecer seu produto de dados. Quando você escolhe regiões personalizadas, sua listagem fica visível em todas as regiões do Snowflake Marketplace atuais, mas os consumidores só podem obter seu produto de dados nas regiões que você especificar. Sua listagem também não ficará automaticamente disponível em nenhuma nova região.
- Para listagens pagas, Custom regions é selecionado por padrão. Listagens pagas estão disponíveis apenas nas regiões suportadas e quaisquer regiões futuras com suporte adicionadas pelo Snowflake.
Revise o intervalo de atualização configurado no nível da conta. Se você precisar usar um intervalo de atualização diferente, consulte Definir o intervalo de atualização no nível da conta.
Se você não tiver um warehouse padrão definido, selecione um warehouse para usar para preenchimento automático.
Selecione Save and Enable Fulfillment.

O preenchimento automático para a listagem agora está ativado, mas o produto de dados anexado à listagem não é preenchido em nenhuma região até que a listagem seja publicada e um consumidor solicite o produto de dados. Consulte Como funciona o preenchimento automático.

Configuração do preenchimento automático em nível de objeto¶

Se você quiser transferir automaticamente o produto de dados associado à sua listagem para outras regiões do Snowflake, configure o preenchimento automático. Você também pode usar o preenchimento automático SUB_DATABASE e optar por preencher apenas as tabelas e exibições em um produto de dados para uma região remota usando o preenchimento automático. Isso pode ajudar a reduzir custos e a gerenciar seu produto de dados preenchido automaticamente.

As etapas abaixo descrevem como configurar o preenchimento automático em nível de objeto para uma listagem. Como parte de um fluxo de trabalho típico, você configura o preenchimento automático em nível de objeto ao configurar a disponibilidade da região (para uma listagem publicada no Snowflake Marketplace) ou quando você adiciona um consumidor localizado em outra região (para uma listagem compartilhada de forma privada).

Criar uma listagem. Consulte Criar uma nova listagem.
Ative um produto de dados que contenha apenas objetos compatíveis.
Configure regiões ou contas para compartilhar e começar a configurar o preenchimento automático:

Para uma listagem publicada no Snowflake Marketplace:
1. Localize a seção Region Availability e selecione Add.
2. Para Region availability, mantenha o padrão de All regions ou selecione Custom regions para sua listagem.
Para uma listagem compartilhada de forma privada, adicione uma conta de consumidor em uma região remota.
Selecione o intervalo de atualização de sua preferência para atualizar o produto de dados em regiões remotas.
Publique sua listagem ou salve-a como um rascunho.

Set up auto-fulfillment for a listing that spans databases¶

Providers can create a single listing that spans databases, eliminating the need to create one combined database per listing. In this case, all listings associated with a database are auto-fulfilled together.

Workflow¶

A provider has a database (main database) that they want to share. They also have views in that database that reference objects in another database (referenced database).
The provider creates a share in the main database.
Using GRANT <privilégio> … TO SHARE, the provider grants the following required privileges to the share:
1. The provider grants the USAGE privilege on the main database that contains the view to the share.
2. The provider grants the REFERENCE_USAGE privilege on the referenced database to the share.
3. The provider grants the USAGE privilege on the schema that contains the view to the share.
4. The provider grants the SELECT privilege on the view to the share.
The provider creates a listing with the share and enables auto-fulfillment for cross-region cross-cloud consumers.

For more information, see Compartilhamento de dados de vários bancos de dados.

Supported reference types¶

When REFERENCE_USAGE is granted on a database to a share, the following reference types are supported:

A view referencing a table or view in another database.
Tables or views with policies when these policies are stored in another database.
Tables or views with tags when these tags are stored in another database.

Nota

A tag without an attached policy in a different database will only be replicated if reference usage is granted. Otherwise, replication will be skipped. See GRANT <privilégio> … TO SHARE for more information. If the tag is used in tag-based masking, then the share is treated as a table or view with row-access policies.

Limitations¶

Snowflake groups listings together when refreshing the data. Setting up listings that span multiple databases can change the way listings are grouped. As a result, the following might be affected:

The listing refresh history can be missing or incorrect after update the auto-fulfillment schedule.
Setting the refresh_schedule_override option may be required. When this option is missing, a resulting error message will include the list of listings that were affected by the change in the order that the listings were grouped.

Usage notes¶

When setting up auto-fulfillment, if the selected and referenced databases include existing listings, then the values in the Data product refresh section default to the existing refresh schedule. As a result, changes to the auto-fulfillment refresh schedule apply to all other listings associated with this database and with the referenced database.

Examples¶

For examples on how to create a secure view that references objects and other views in one or more databases, see the Share data from multiple databases examples.

After you create a secure view, you can create a listing that includes the secure view and set up auto-fulfillment on the listing. For examples on how to create listings on the Snowflake Marketplace, see Create and publish a listing.