Solução de problemas do Collaboration Data Clean Rooms

Consulte as dicas de solução de problemas a seguir quando você encontrar erros ao trabalhar com o Collaboration Data Clean Rooms.

Colaborações

Erro:

Convite pendente para colaboração: <collaboration name> não encontrado, embora GET_STATUS mostre a conta como INVITED.

Causa:

Se uma tentativa de ingressão inicial falhou por algum motivo, as tentativas posteriores provavelmente falharão por esse motivo.

Solução:

Exclua e recrie a colaboração.

 

Erro:

Uma colaboração que você criou não fica visível na conta de um colaborador.

Causa:

Há vários motivos possíveis:

  • A colaboração foi criada em uma região de hospedagem em nuvem diferente e você não habilitou o preenchimento automático entre nuvens.

  • Você não compartilhou a colaboração, compartilhou a colaboração com a conta errada ou abriu a conta de colaborador errada na UI/CLI do Snowsight/SDCR. Confirme se a conta em que você espera ver sua colaboração é aquela com a qual você compartilhou a colaboração e que você fez login nessa conta compartilhada.

  • Há um pequeno atraso entre a publicação de uma colaboração e quando ela se torna visível para o colaborador.

Solução:

Verifique se a conta do colaborador corresponde à da sua especificação de colaboração e se o preenchimento automático entre nuvens está habilitado, se necessário. Aguarde alguns momentos para que a colaboração se propague.

 

Erro:

ReferenceUsageGrantMissingException: Reference usage grants are required for the following databases in your account ... quando um provedor de dados tenta ingressar na colaboração. Os provedores de dados veem esta mensagem quando tentam ingressar em uma colaboração e quando compartilharam dados dos quais não têm REFERENCE_USAGE. Este é um comportamento esperado.

Solução:

A mensagem de erro inclui um nome de banco de dados e um nome de compartilhamento. Qualquer pessoa com REFERENCE_USAGE dos dados ou um ACCOUNTADMIN deve executar o seguinte comando SQL, fornecendo os nomes do banco de dados e do compartilhamento especificados na mensagem de erro:

GRANT REFERENCE_USAGE ON DATABASE <database_name> TO SHARE <share_name>;

Depois que REFERENCE_USAGE for concedido com sucesso, o provedor de dados poderá ingressar na colaboração.

API e permissões

Erro:

Função definida pelo usuário <function name> desconhecida

Causa:

Se for um procedimento documentado para a API Collaboration DCR, pode ser um erro de digitação no procedimento.

Se você não cometeu um erro de digitação no nome do procedimento, ou se for um procedimento do sistema (isto é, ele tem $ no nome), talvez esteja usando uma versão mais antiga da API e tenha que atualizar a versão da API de salas limpas.

Solução:

  • Confirme que você digitou o procedimento corretamente e, se estiver incorreto, tente de novo com a ortografia adequada.

  • Para atualizar sua instalação, execute o seguinte código SQL:

USE ROLE ACCOUNTADMIN;
CALL SAMOOHA_BY_SNOWFLAKE.APP_SCHEMA.PREPARE_MOUNT_SCRIPT();
EXECUTE IMMEDIATE FROM @SAMOOHA_BY_SNOWFLAKE.APP_SCHEMA.MOUNT_CODE_STAGE/dcr_loader.sql;

 

Erro:

Listing 'listing name' is not fulfilled to your current region. Please request the listing, or if already requested, retry after some time

Causa:

Você está usando uma versão mais antiga da API de salas limpas. Esse problema foi corrigido em uma versão mais recente.

Solução:

Atualize sua instalação de salas limpas.

 

Erro:

SQL compilation error: Unknown user-defined function SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.COLLABORATION.RUN

Causa:

Você digitou errado alguma parte do nome do procedimento totalmente qualificado ou não tem privilégios para executá-lo.

Solução:

Confirme que você usou o nome correto do procedimento. Se você não usa SAMOOHA_APP_ROLE, tente alternar para essa função para ver se o mesmo erro ocorre. Se não ocorrer, é um erro de privilégio.

 

Erro:

Função definida pelo usuário SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.<namespace>.<procedure name> desconhecida

Causa:

Um dos seguintes:

  • Você usou o namespace errado. Certifique-se de chamar o namespace adequado COLLABORATION ou REGISTRY.

  • Você cometeu um erro no nome da função. Consulte o guia de referência para ver a nomenclatura adequada.

  • Você usa uma função RBAC que não tem permissões para chamar o procedimento.

  • Você não tem SAMOOHA_APP_ROLE.

Solução:

  • Confirme que você digitou o procedimento corretamente e usou o namespace correto.

  • Tente alternar para SAMOOHA_APP_ROLE para ver se você pode executar o procedimento. Se puder, o problema é de privilégios insuficientes em sua função atual. Peça que alguém com SAMOOHA_APP_ROLE conceda a você os privilégios adequados.

  • Para verificar se você tem SAMOOHA_APP_ROLE, execute o seguinte comando:

SELECT CURRENT_USER();
SHOW GRANTS TO USER <current_user_name> ->> SELECT * FROM $1 WHERE "role" = 'SAMOOHA_APP_ROLE';

Se não aparecer nenhum resultado, peça que o administrador conceda a você acesso de API à colaboração.

Pacotes de código

Erro:

CodeSpecAlreadyExistsException

Causa:

Especificação do pacote de código com os mesmos nome e versão já registrados.

Solução:

Use uma versão diferente ou atualize a versão existente.

 

Erro:

SpecValidationError

Causa:

O YAML não está de acordo com o esquema.

Solução:

Verifique os campos e o formato obrigatórios.

 

Erro:

CodeSpecStageNotAccessibleError

Causa:

A área de preparação referenciada no artefato não está acessível.

Solução:

Conceda acesso à área de preparação ou verifique se ela existe.

 

Erro:

CodeSpecArtifactNotFoundAtStageError

Causa:

Arquivo não encontrado no caminho da área de preparação especificado.

Solução:

Carregue o arquivo para a área de preparação antes do registro.

 

Erro:

StageDirectoryNotEnabledError

Causa:

A área de preparação não tem o DIRECTORY habilitado.

Solução:

Habilite o diretório na área de preparação: ALTER STAGE ... SET DIRECTORY = (ENABLE = TRUE)

 

Erro:

CodeSpecNotFoundForOwnerException

Causa:

O modelo faz referência a uma especificação de pacote de código não registrada.

Solução:

Registre a especificação do pacote de código antes de registrar o modelo.