Utilisation des APIs du développeur pour envoyer les résultats au fournisseur pour activation

Parfois, les collaborateurs souhaitent que le consommateur exécute une analyse, puis renvoie les résultats au fournisseur pour activation. Cette rubrique décrit comment utiliser les APIs du développeur pour envoyer les résultats du consommateur au fournisseur.

Le flux de base pour l’activation du fournisseur est :

Fournisseur:

  • Crée un modèle que le consommateur peut exécuter pour envoyer des résultats au fournisseur pour activation.

  • Lie la table samooha_by_snowflake_local_db.library.temp_public_key dans la salle blanche.

Consommateur:

Exécute le modèle du fournisseur pour renvoyer les résultats au compte Snowflake du fournisseur.

Fournisseur:

Affiche les vues dans une table de son compte Snowflake.

Créer un modèle pour l’activation du fournisseur

Un modèle utilisé pour activer les résultats est similaire à un modèle utilisé pour exécuter une analyse. Par exemple, il est ajouté à la salle blanche avec la commande provider.add_custom_sql_template comme modèle d’analyse. Cependant, un modèle d’activation présente les différences importantes suivantes :

  • Le nom du modèle d’activation doit commencer par la chaîne activation. Par exemple, un modèle d’activation nommé activation_my_template répond à l’exigence.

  • Le modèle d’activation doit créer une table avec un nom conforme à des conventions spécifiques et renvoie explicitement le nom de la table.

Définition de la table dans un modèle d’activation

Pour conserver les résultats d’activation dans la salle blanche, chaque modèle d’activation doit créer une table. Il y a deux exigences pour ce tableau :

  • Le nom de la table doit commencer par la chaîne cleanroom.activation_data_. Par exemple, une table nommée cleanroom.activation_data_analysis_results répond à l’exigence.

  • La partie de la définition du modèle qui crée la table doit renvoyer la chaîne qui a été ajoutée à cleanroom.activation_data_ pour former le nom de la table. Par exemple, si le nom de la table est cleanroom.activation_data_analysis_results, alors la chaîne analysis_results doit être retournée.

Voici un exemple de ce qui doit être inclus dans la définition du modèle pour définir une table et l’exporter :

BEGIN
  CREATE OR REPLACE TABLE cleanroom.activation_data_analysis_results AS
    SELECT * FROM identifier({{ my_table[0] }})
  RETURN 'analysis_results';
END;
Copy

Pour plus d’informations sur l’appel de la commande provider.add_custom_sql_template pour ajouter un modèle d’activation à une salle blanche, voir Snowflake Data Clean Rooms : guide de référence pour l’API fournisseurs.

Renvoyer les résultats au fournisseur

Le consommateur renvoie les résultats au fournisseur en appelant la commande consumer.run_activation pour exécuter le modèle d’activation, qui est similaire à l’exécution de la commande consumer.run_analysis. La différence réside dans le deuxième argument, qui spécifie une chaîne qui aide le fournisseur à identifier le contenu de l’activation.

Par exemple, le consommateur peut appeler :

CALL samooha_by_snowflake_local_db.consumer.run_activation(
  'activation_clean_room',
  'my_activation_segment',
  'activation_custom_template',
  ['consumer_source_table'],
  ['provider_source_table'],
  object_construct(
    'dimensions', ['p.CAMPAIGN'],
    'where_clause', 'p.EMAIL=c.EMAIL'
));
Copy

Pour plus d’informations sur la syntaxe de la commande consumer.run_activation, consultez Snowflake Data Clean Rooms : guide de référence pour l’API de consommateur.

Voir les résultats activés en tant que fournisseur

Une fois que le consommateur a activé les résultats auprès du fournisseur, le fournisseur peut visualiser ces résultats dans son compte Snowflake (pas dans l’environnement de la salle blanche). Notez que le fournisseur doit se connecter à son environnement de salle blanche avant de se connecter à son compte Snowflake pour afficher les résultats.

Pour plus d’informations, consultez Voir les résultats activés.

Langage: Français