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.
In the navigation menu, select Marketplace » 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.
In the navigation menu, select Marketplace » 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.

Configurar o preenchimento automático para uma listagem que abrange vários bancos de dados¶

Os provedores podem criar uma única listagem que abrange vários bancos de dados, eliminando a necessidade de criar um banco de dados combinado por listagem. Nesse caso, todas as listagens associadas a um banco de dados são preenchidas automaticamente em conjunto.

Fluxo de trabalho¶

Um provedor tem um banco de dados (banco de dados principal) que deseja compartilhar. Ele também tem exibições nesse banco de dados que fazem referência a objetos em outro banco de dados (banco de dados referenciado).
O provedor cria um compartilhamento no banco de dados principal.
Usando GRANT <privilégio> … TO SHARE, o provedor concede os seguintes privilégios necessários ao compartilhamento:
1. O provedor concede ao compartilhamento o privilégio USAGE no banco de dados principal que contém a exibição.
2. O provedor concede ao compartilhamento o privilégio REFERENCE_USAGE no banco de dados referenciado.
3. O provedor concede ao compartilhamento o privilégio USAGE no esquema que contém a exibição.
4. O provedor concede ao compartilhamento o privilégio SELECT na exibição.
O provedor cria uma listagem com o compartilhamento e habilita o preenchimento automático para consumidores entre regiões e nuvens.

Para obter mais informações, consulte Compartilhamento de dados de vários bancos de dados.

Tipos de referência compatíveis¶

Quando REFERENCE_USAGE é concedido a um compartilhamento em um banco de dados, os seguintes tipos de referência são compatíveis:

Uma exibição que faz referência a uma tabela ou exibição em outro banco de dados.
Tabelas ou exibições com políticas quando essas políticas estão armazenadas em outro banco de dados.
Tabelas ou exibições com tags quando essas tags estão armazenadas em outro banco de dados.

Nota

Uma tag sem uma política associada em um banco de dados diferente só será replicada se o uso de referência for concedido. Caso contrário, a replicação será ignorada. Consulte GRANT <privilégio> … TO SHARE para obter mais informações. Se a tag for utilizada em mascaramento baseado em tags, o compartilhamento será tratado como uma tabela ou exibição com políticas de acesso a linhas.

Limitações¶

O Snowflake agrupa listagens ao atualizar os dados. Configurar listagens que abrangem vários bancos de dados pode alterar a forma como as listagens são agrupadas. Como resultado, os itens a seguir podem ser afetados:

O histórico de atualização de listagens pode estar ausente ou incorreto após a atualização da programação de preenchimento automático.
A configuração da opção refresh_schedule_override pode ser necessária. Quando essa opção estiver ausente, a mensagem de erro resultante incluirá a lista de listagens que foram afetadas pela alteração na ordem em que foram agrupadas.

Notas de uso¶

Ao configurar o preenchimento automático, se os bancos de dados selecionados e referenciados incluírem listagens existentes, os valores na seção Data product refresh assumirão por padrão a programação de atualização existente. Como resultado, as alterações na programação de atualização do preenchimento automático se aplicam a todas as outras listagens associadas a este banco de dados e ao banco de dados referenciado.

Exemplos¶

Para exemplos de como criar uma exibição segura que faz referência a objetos e outras exibições em um ou mais bancos de dados, consulte Exemplos de compartilhamento de dados de vários bancos de dados.

Depois de criar uma exibição segura, você pode criar um listagem que inclua a exibição segura e configurar o preenchimento automático na listagem. Para ver exemplos de como criar listagens no Snowflake Marketplace, consulte Criar e publicar um listagem.