Dépannage des salles blanches de données de collaboration

Consultez les conseils de dépannage suivants lorsque vous rencontrez des erreurs lorsque vous travaillez avec des salles blanches de données de collaboration.

Collaborations

Erreur:

Invitation en attente pour la collaboration : <collaboration name> introuvable bien que GET_STATUS affiche le compte sous la forme INVITED.

Cause:

Si une tentative de jointure initiale a échoué pour une raison quelconque, les tentatives de jointure ultérieures échoueront probablement pour cette même raison.

Solution:

Supprimez et recréez la collaboration.

 

Erreur:

Une collaboration que vous avez créée n’est pas visible dans le compte d’un collaborateur.

Cause:

Plusieurs raisons sont possibles :

  • La collaboration a été créée dans une autre région d’hébergement Cloud et vous n’avez pas activé l’:doc:` exécution automatique inter-cloud </user-guide/cleanrooms/laf>`.

  • Vous n’avez pas partagé la collaboration, vous avez partagé la collaboration avec le mauvais compte, ou vous avez ouvert le mauvais compte d’un collaborateur dans l’UI/laCLI de Snowsight/SDCR. Confirmez que le compte où vous vous attendez à voir votre collaboration est celui avec lequel vous avez partagé la collaboration, et que vous êtes connecté à ce compte partagé.

  • Il y a un petit délai entre la publication d’une collaboration et le moment où elle devient visible pour le collaborateur.

Solution:

Vérifiez que le compte du collaborateur correspond à celui de votre spécification de collaboration et que l’exécution automatique inter-cloud est activée si nécessaire. Attendez quelques instants que la collaboration se propage.

 

Erreur:

ReferenceUsageGrantMissingException: Reference usage grants are required for the following databases in your account ... lorsqu’un fournisseur de données tente de rejoindre la collaboration. Les fournisseurs de données verront ce message lorsqu’ils essaieront de rejoindre une collaboration et qu’ils ont partagé des données sur lesquelles ils ne disposent pas de REFERENCE_USAGE. Il s’agit d’un comportement attendu.

Solution:

Le message d’erreur comprend un nom de base de données et un nom de partage. Un utilisateur disposant de REFERENCE_USAGE sur les données, ou un ACCOUNTADMIN, doit exécuter la commande SQL suivante, en fournissant les noms de la base de données et du partage indiqués dans le message d’erreur :

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

Une fois REFERENCE_USAGE accordé avec succès, le fournisseur de données peut rejoindre la collaboration.

API et autorisations

Erreur:

Fonction définie par l’utilisateur inconnue <function name>

Cause:

S’il s’agit d’une procédure documentée pour l’API DCR de collaboration, vous avez peut-être mal orthographié la procédure.

Si vous n’avez pas mal orthographié le nom de la procédure, ou si la procédure est une procédure système (c’est-à-dire qu’elle possède un $ dans son nom), vous utilisez peut-être une ancienne version de l’API et devez mettre à niveau la version de votre API des salles blanches.

Solution:

  • Vérifiez que vous avez bien orthographié la procédure et, si ce n’est pas le cas, réessayez avec la bonne orthographe.

  • Pour mettre à jour votre installation, exécutez le code SQL suivant :

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;

 

Erreur:

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

Cause:

Vous utilisez une ancienne version de l’API des salles blanches. Ce problème a été corrigé dans une version plus récente.

Solution:

Mettez à jour votre installation de salles blanches.

 

Erreur:

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

Cause:

Soit vous avez mal orthographié une partie du nom complet de la procédure, soit vous ne disposez pas des privilèges nécessaires pour exécuter cette procédure.

Solution:

Confirmez que vous avez utilisé le nom correct de la procédure. Si vous n’utilisez pas SAMOOHA_APP_ROLE, essayez de passer à ce rôle pour voir si la même erreur se produit. Dans le cas contraire, il s’agit d’une erreur de privilège.

 

Erreur:

Fonction définie par l’utilisateur inconnue SAMOOHA_BY_SNOWFLAKE_LOCAL_DB <namespace>.<procedure name>

Cause:

Un des éléments suivants :

  • Vous avez utilisé le mauvais espace de noms. Assurez-vous d’appeler la COLLABORATION ou l’espace de noms REGISTRY correct.

  • Vous avez mal saisi le nom de la fonction. Consultez le guide de référence pour connaître le nom correct.

  • Vous utilisez un rôle RBAC qui n’a pas les autorisations nécessaires pour appeler la procédure.

  • Vous n’avez pas le rôle SAMOOHA_APP_ROLE.

Solution:

  • Confirmez que vous avez bien orthographié la procédure et utilisé l’espace de noms correct.

  • Essayez de passer au rôle SAMOOHA_APP_ROLE pour voir si vous pouvez exécuter la procédure. Si vous le pouvez, le problème est l’insuffisance des privilèges pour votre rôle actuel. Demander à quelqu’un avec le rôle SAMOOHA_APP_ROLE de:ref:` vous accorder des privilèges appropriés <label-dcr_collab_about_rbac_roles>`.

  • Pour vérifier si vous avez le rôle SAMOOHA_APP_ROLE, exécutez la commande suivante :

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

Si vous n’obtenez aucun résultat, demandez à un administrateur de vous donner l’accès à la collaboration via l’API.

Bundles de code

Erreur:

CodeSpecAlreadyExistsException

Cause:

Spécification de bundle de code avec le même nom et la même version déjà enregistrée.

Solution:

Utilisez une autre version ou mettez à jour la version existante.

 

Erreur:

SpecValidationError

Cause:

YAML n’est pas conforme au schéma.

Solution:

Vérifiez les champs obligatoires et le format.

 

Erreur:

CodeSpecStageNotAccessibleError

Cause:

La zone de préparation référencée dans l’artefact n’est pas accessible.

Solution:

Accordez l’accès à la zone de préparation ou vérifiez que la zone de préparation existe.

 

Erreur:

CodeSpecArtifactNotFoundAtStageError

Cause:

Fichier introuvable dans le chemin de zone de préparation spécifié.

Solution:

Chargez le fichier dans la zone de préparation avant de l’enregistrer.

 

Erreur:

StageDirectoryNotEnabledError

Cause:

La zone de préparation n’a pas DIRECTORY activé.

Solution:

Activez le répertoire sur la zone de préparation : ALTER STAGE ... SET DIRECTORY = (ENABLE = TRUE)

 

Erreur:

CodeSpecNotFoundForOwnerException

Cause:

Le modèle fait référence à une spécification de bundle de code non enregistrée.

Solution:

Enregistrez la spécification du bundle de code avant d’enregistrer le modèle.