Gerenciando o preenchimento automático entre nuvens em Snowflake Data Clean Rooms¶
Sobre o preenchimento automático entre nuvens¶
No ambiente de clean room padrão, uma clean room pode ser compartilhada apenas com contas na mesma região de nuvem. Ou seja, o provedor e o consumidor devem estar na mesma região de nuvem.
Se quiser colaborar com um colaborador cuja conta esteja em uma região diferente da sua conta, você deve ativar o preenchimento automático entre nuvens para seu ambiente de clean room e para sua clean room, conforme mostrado nesta página.
Você pode determinar sua própria região de nuvem executando SELECT CURRENT_REGION();
Como habilitar o preenchimento automático entre nuvens¶
Para permitir colaboradores de uma região diferente:
O administrador da clean room deve ativar o preenchimento automático entre nuvens para a conta da clean room nas contas do provedor e do consumidor.
A próxima etapa depende de seu ambiente:
Ao criar ou ingressar em uma clean room na UI, não são necessárias etapas adicionais.
Ao criar uma clean room com a API, o provedor e o consumidor devem seguir as etapas adicionais descritas abaixo para permitir o uso entre nuvens.
Habilitar o preenchimento automático entre nuvens para uma conta de clean room¶
Um administrador de clean rooms deve executar as seguintes etapas na UI ou API para ativar o preenchimento automático entre nuvens para uma conta de clean room:
Navegue até a página de login do Snowflake Data Clean Rooms.
Digite seu endereço de e-mail e selecione Continue.
Insira sua senha.
Se você estiver associado a vários ambientes de sala limpa, selecione a conta Snowflake que está configurando.
Selecione Admin > Snowflake Admin.
Selecione Login to Snowflake, e autentique como um usuário Snowflake com a função ACCOUNTADMIN.
Ative Cross-Cloud Auto-Fulfillment.
O provedor ou o consumidor não precisa realizar nenhuma etapa adicional ao criar ou participar de uma clean room.
Administrador
O administrador do provedor e consumidor deve habilitar o preenchimento automático entre nuvens para a conta Snowflake. Isso pode ser feito na UI de clean room, ou usando a seguinte API de procedimento:
USE ROLE ACCOUNTADMIN; CALL SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.library.enable_laf_on_account();
Provedor e consumidor
Depois que o preenchimento automático entre nuvens for ativado para uma conta, tanto o provedor quanto consumidor deverão ativar o preenchimento automático entre nuvens para a clean room sempre que criarem ou ingressarem em uma clean room entre regiões de nuvem.
Para uso básico da clean room, o consumidor precisa chamar apenas
consumer.request_laf_cleanroom
.Para oferecer suporte à funcionalidade completa descrita abaixo, ambos os lados devem seguir estas etapas adicionais:
O consumidor chama
consumer.setup_cleanroom_request_share_for_laf
.Em seguida, o provedor chama
provider.request_laf_cleanroom_requests
eprovider.mount_laf_cleanroom_requests_share
.Para a ativação do provedor, o consumidor chama
consumer.setup_activation_share_to_laf_consumer
.Quando a configuração completa estiver concluída, a seguinte funcionalidade adicional poderá ser implementada da mesma forma que os colaboradores da mesma região:
Registro de solicitações
Solicitações de modelos de clientes
Análises executadas pelo provedor
Ativação do provedor
Exemplo de configuração completa:
Provedor: o provedor cria, compartilha e publica uma clean room da maneira padrão.
USE ROLE SAMOOHA_APP_ROLE; USE WAREHOUSE APP_WH; SET cleanroom_name = 'LAF example'; CALL SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.provider.cleanroom_init($cleanroom_name); CALL samooha_by_snowflake_local_db.provider.link_datasets($cleanroom_name, ['SAMOOHA_SAMPLE_DATABASE.DEMO.CUSTOMERS']); CALL SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.provider.set_default_release_directive($cleanroom_name, 'V1_0', '0'); CALL SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.provider.add_consumers($cleanroom_name, $consumer_locator, $consumer_account_name); CALL SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.provider.create_or_update_cleanroom_listing($cleanroom_name);Consumidor: o consumidor instala a clean room e configura a funcionalidade completa para uma clean room entre regiões.
-- Async request to set up Cross-Cloud Auto-Fulfillment. -- This must be done before installing the clean room. -- Continue calling until it returns status FULFILLED. This can take 10 minutes. CALL SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.consumer.request_laf_cleanroom( $cleanroom_name,$provider_locator); -- Consumer can now install and use the clean room in a limited fashion. -- However, if they want full functionality they must take the following steps. CALL SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.consumer.install_cleanroom( $cleanroom_name, $provider_locator); -- Set up cross-region sharing. CALL SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.consumer.setup_cleanroom_request_share_for_laf( $cleanroom_name, $provider_data_sharing_account_locator); -- Continue with clean room configuration, but don't use full functionality until -- the provider has completed the next section.Provedor: depois que o consumidor tiver definido a funcionalidade entre regiões para a clean room, o provedor deverá configurá-la em seu lado.
USE ROLE SAMOOHA_APP_ROLE; -- Call request_laf_cleanroom_requests until it reports the status as FULFILLED, -- then call mount_laf_cleanroom_requests_share. These steps can take 10 minutes -- or more to complete. CALL samooha_by_snowflake_local_db.provider.request_laf_cleanroom_requests( $cleanroom_name, $consumer_locator); CALL samooha_by_snowflake_local_db.provider.mount_laf_cleanroom_requests_share( $cleanroom_name, $consumer_locator);A funcionalidade completa já está disponível.
Custos associados à colaboração entre regiões¶
Há custos adicionais associados a colaboradores em uma região diferente. Para obter mais informações sobre como esses custos são incorridos, consulte Custos de autoatendimento.
Limitações na colaboração entre regiões¶
Existem as seguintes limitações na colaboração entre regiões:
Os colaboradores devem compartilhar a mesma região de hospedagem de aplicativos da Web. Por exemplo, se a região de hospedagem do aplicativo da Web para uma conta for Amazon Web Services: US East (N. Virginia) e a região de hospedagem Web de outra conta for Amazon Web Services: Asia Pacific (Mumbai), então os dois clientes Snowflake não podem colaborar. Para determinar se os dois colaboradores compartilham a mesma região de hospedagem de aplicativo da Web, consulte Hospedagem de aplicativos da Web.
Um provedor não pode usar privacidade diferencial na sala limpa.
Os colaboradores não podem vincular tabelas externas e tabelas iceberg em salas limpas.
Um consumidor não pode executar uma análise de vários provedores.
Os colaboradores não podem usar políticas de mascaramento ou políticas de acesso a linhas.