Configurer les annonces d’organisation

Cette page présente les configurations pour les annonces d’organisation dans Snowflake. Vous y trouverez des détails sur le ciblage des comptes, l’ajout de rôles, les régions d’accès et les paramètres d’exécution automatique.

Définir le localisateur d’annonce uniforme ou le nom de l’annonce

Le localisateur d’annonce uniforme (ULL) est un identificateur unique qui représente l’annonce et son produit de données, les traitant comme un tout. Le nom de l’annonce est différent du titre de l’annonce : plusieurs annonces peuvent avoir le même titre, mais chaque annonce doit avoir un nom d’annonce unique ou ULL. L’ULL complet est formé de trois éléments délimités par le symbole « $ ». Le premier élément est le nom de l’organisation du fournisseur, le deuxième élément est le profil du fournisseur INTERNAL et le troisième élément est le nom de l’annonce. L’ULL ne peut être modifié après la publication de l’annonce. Bien qu’il comporte trois parties, l’ULL est traité comme un seul nom dans les requêtes. Par exemple, vous pouvez effectuer une requête sur une table dans une annonce comme celle-ci :

SELECT * FROM "ORGDATACLOUD$INTERNAL$MY_LISTING_NAME_123".PUBLIC.TABLE_FROM_LISTING;
Copy

Lorsque vous créez une annonce, donnez-lui un nom clair et descriptif. Les consommateurs trouvent plus rapidement les annonces par leur nom que par leur titre, et un nom descriptif est plus facile à utiliser dans les requêtes.

Définir qui peut découvrir une annonce d’organisation et y accéder

Le public cible de vos annonces d’organisation est toujours votre Marketplace interne.

Malgré les restrictions imposées par une annonce interne, vous pouvez toujours contrôler qui peut découvrir l’annonce et y accéder. Vous pouvez marquer une annonce comme découvrable et accessible individuellement. En d’autres termes, vous pouvez découvrir une annonce mais pas y accéder.

En général, vous pouvez spécifier l’accès ou la découverte aux niveaux suivants :

  • Tous les membres de votre compte

  • Comptes spécifiques

  • Comptes spécifiques, mais limités par rôles spécifiques

Par exemple, l’élément access définit qui peut accéder à une annonce. De même, l’élément discovery définit qui peut découvrir une annonce.

Autoriser tous les comptes à accéder à l’annonce.

organization_targets:
   access:
   - all_accounts : true
Copy

Autoriser des comptes spécifiques à accéder à l’annonce.

organization_targets:
   access:
   - account: 'Account1'
   - account: 'Account2'
Copy

Autoriser des comptes spécifiques à accéder à l’annonce, mais uniquement pour les rôles donnés.

organization_targets:
   access:
      - account: 'Account1'
         roles: [<role1>, <role2>, <role3>]
Copy

Permettre à tous les comptes de découvrir l’annonce.

organization_targets:
   discovery:
   - all_accounts : true
Copy

Permettre à des comptes spécifiques de découvrir l’annonce.

organization_targets:
   discovery:
   - account: 'Account1'
   - account: 'Account2'
Copy

Autoriser des comptes spécifiques à découvrir l’annonce, mais uniquement pour les rôles donnés.

organization_targets:
   discovery:
      - account: 'Account1'
         roles: [<role1>, <role2>, <role3>]
Copy

De la même manière, l’accès aux régions est défini avec l’attribut regions_attribute :

locations:
  access_regions:
     - name: "ALL"
Copy
locations:
   access_regions:
     - name: "AWS_US_WEST_2"
     - name: "AZURE_CENTRALINDIAUS-EAST"
Copy

Spécifier l’approbateur et le contact d’assistance

En option, vous pouvez spécifier une adresse e-mail ou un lien vers le système de billetterie interne pour l’approbateur et le contact d’assistance.

support_contact: "support@somedomain.com"
approver_contact: "approver@somedomain.com"
Copy

Définir les options d’exécution automatique pour une annonce d’organisation

Les annonces d’organisation auxquelles sont attachés des partages de données et des applications utilisent toutes deux l’exécution automatique, mais chacune utilise des méthodes différentes. C’est pourquoi les planifications d’actualisation sont différentes. Pour les partages, la planification de l’actualisation est définie au niveau de la base de données. Pour les applications, elle est définie au niveau du compte.

Si vous devez utiliser l’exécution automatique, vous pouvez la définir lors de l’exécution de CREATE ORGANIZATIONAL LISTING OR ALTER LISTING en modifiant l’attribut auto_fulfillment dans les champs du manifeste de l’annonce.

auto_fulfillment:
   refresh_type: SUB_DATABASE
   refresh_schedule: '10 MINUTE'
Copy