Solução de problemas da Snowflake Data Clean Rooms¶

Problemas de instalação¶

• Consulte a seção de solução de problemas de instalação.

• Confirme se você atualizou sua política de redes para permitir que a UI acesse seus dados.

Analysis and template issues¶

Erro:

Falha durante a expansão da exibição compartilhada <CLEAN ROOM VIEW NAME> como proprietário da exibição: Permissão insuficiente para resolver a tabela externa/iceberg <TABLE_NAME> compartilhada pelo aplicativo SAMOOHA_CLEANROOM_APP_<CLEAN ROOM ID>

Causa:

Você está tentando acessar tabelas externas ou Iceberg, mas elas não estão habilitadas nas contas do provedor e do consumidor.

Solução:

Certifique-se de que as contas do provedor e do consumidor tenham :ref:` tabelas externas e Iceberg habilitadas <label-cleanrooms_external_iceberg_tables>`.

Erro:

Erro de compilação SQL: Falha durante a expansão da exibição compartilhada "<CLEAN ROOM VIEW NAME>" como proprietário da exibição: O objeto "<some object name>" não existe ou não está autorizado.

Causa:

As concessões de salas limpas não existem mais no conjunto de dados que você está tentando acessar. Muito provavelmente isso ocorre porque o objeto de origem foi renomeado ou substituído.

Solução:

• Se a tabela foi renomeada, altere o nome de volta para o que está vinculado na sala limpa. Você também pode precisar registrar o objeto novamente.

• Se a tabela foi recriada, registre o objeto novamente na sala limpa.

Erro:

Query returns zero results and you think that’s wrong.

Possíveis causas e soluções:

• Confirme se nenhum dos lados tem uma política de mascaramento nos dados que possa impedir a junção ou exibição.

• Confirme se as colunas de junção estão formatadas da mesma maneira.

• Confirm that you are not falling below any fixed threshold settings. The audience overlap has a default threshold of five, meaning that fewer than five rows will be omitted from the results. Ask the provider what the threshold is, and confirm whether you have any overlaps greater than that number; temporarily modify the overlap specifications to guarantee large segment groups to see whether you get results then.

Erro:

Uncaught exception of type 'STATEMENT_ERROR' ... SQL compilation error: invalid URL prefix found ...

Causa:

The template uses a string value, rather than identifier, for a column or table name. This happens when the template doesn’t properly convert string variables into identifiers by using either the sqlsafe filter or the IDENTIFIER function.

For example, passing in p.col1 to my_column to the template SELECT {{ my_column }} ... resolves to SELECT "p.col1" .... «p.col1» is a string, not a valid identifier (and p. is interpreted as a URL prefix).

Solução:

Apply either the IDENTIFIER function (preferred) or the sqlsafe filter to the variable:

• SELECT IDENTIFIER({{ my_column }}) ... (Preferred)

• SELECT {{ my_column | sqlsafe }} ...

Erro:

**FAILURE**: Unauthorized columns: column_name

Causa:

Your query uses a column of collaborator data that is not part of the collaborator’s usage policy in the clean room. For example, you are trying to SELECT a column of collaborator data that is not in their column policy.

Solução:

Use a column that your collaborator has approved for projection, joining, or activation in your query. Inspect the template for policy filters by calling consumer.view_template_definition, then see which columns the provider allows you to project or join by calling consumer.view_provider_join_policy or consumer.view_provider_column_policy. Finally either update your query to pass in an approved column, or ask your collaborator to adjust their usage policy to include the column that you want to use.

Erro:

**FAILURE**: Invalid aliases: P.column name' or **FAILURE**: Invalid aliases: C.column name'

Causa:

You are using uppercase P or C table aliases to scope a column name. You must use lowercase p or c aliases when scoping a column name. (The template itself can use either uppercase or lowercase when declaring the alias.)

Solução:

Always use a lowercase alias when scoping a column.

Example:

-- Always scope the column name with a lowercase alias.
-- The casing of the alias declared for the table doesn't matter.

-- These will fail.
SELECT P.hashed_email FROM mydb.mysch.t1 AS P;
SELECT P.hashed_email FROM mydb.mysch.t1 AS p;

-- These will succeed.
SELECT p.hashed_email FROM mydb.mysch.t1 AS P;
SELECT p.hashed_email FROM mydb.mysch.t1 AS p;

Copy

Erro:

**FAILURE**: Invalid aliases: database name.schema name.column name

Causa:

You must always reference columns using the p or c alias declared for a table. Columns can’t reference a table by its full path.

Invalid: SELECT hashed_email FROM mydb.mysch.t1;

Solução:

Use the p or c (lowercase!) table alias when referencing a column:

Valid: SELECT p.hashed_email FROM mydb.mysch.t1 AS p;

Problemas entre nuvens¶

Erro:

Analysis Execution Failure: 'SnowparkSQLException' due to Database Listing Conflict em uma sala limpa de teste de conta única

Causa:

O preenchimento automático entre nuvens não é compatível com salas limpas de teste de conta única.

Solução:

Desabilite o preenchimento automático entre nuvens nesta conta de sala limpa chamando library.disable_laf_on_account durante o teste ou não tente fazer chamadas de procedimento entre nuvens nesta sala limpa.

Problemas com o conector de dados na nuvem¶

Se você estiver com problemas com um conector de dados externo para AWS, Azure ou Google Cloud Storage, consulte Snowflake Data Clean Rooms:solução de problemas de conectores de dados externos.

Problemas com o log de solicitações¶

Erro:

**Failure**: Request logs unable to be mounted. Try again.

Causa:

A montagem dos logs de solicitações foi bem-sucedida para a sala limpa interna, mas falhou para a sala limpa externa na mesma conta. As salas limpas internas têm menos requisitos do que as externas. Sua instalação atendeu aos requisitos para o uso de salas limpas internas, mas não para externas.

Solução:

Confirme se seu e-mail foi validado pelas salas limpas e se você atende a todos os requisitos da conta de salas limpas.

Problemas de acesso aos dados¶

Problemas com tabelas externas e Iceberg¶

Erro:

Falha durante a expansão da exibição compartilhada <CLEAN ROOM VIEW NAME> como proprietário da exibição: Permissão insuficiente para resolver a tabela externa/iceberg <TABLE_NAME> compartilhada pelo aplicativo SAMOOHA_CLEANROOM_APP_<CLEAN ROOM ID>

Causa:

Tabelas externas ou Iceberg não estão habilitadas nas contas do provedor e do consumidor.

Solução:

Certifique-se de que as contas do provedor e do consumidor tenham :ref:` tabelas externas e Iceberg habilitadas <label-cleanrooms_external_iceberg_tables>`.

Erro:

O consumidor recebe o erro Invalid restricted feature 'external_data' ao vincular uma tabela externa ou Iceberg.

Causa:

O provedor ainda não habilitou tabelas externas e Iceberg.

Solução:

O provedor deve concluir o processo de habilitação de tabelas externas e Iceberg para a conta dele. Se estiver fazendo isso em código, o provedor deverá conferir os resultados da verificação de segurança e, se bem-sucedido, atualizar a versão padrão.

Erro:

Erro Insufficient permission to resolve external/iceberg table ao executar uma análise envolvendo uma tabela externa ou Iceberg.

Causa:

A tabela provavelmente não foi registrada corretamente pelo provedor e pelo consumidor.

Solução:

Leia as informações de registro de tabela externa e Iceberg e siga todas as instruções tanto do lado do provedor quanto do consumidor.