Créer une annonce organisationnelle¶

1. Créer une annonce d’organisation

   1. Connectez-vous à Snowsight.

   2. Sélectionnez Data Products » Provider Studio dans le menu de navigation de gauche.

   3. Sélectionnez + Create Listing » Internal Marketplace.

   4. Sélectionnez + Data Product.

   5. Dans la boîte de dialogue + Data Product, cliquez sur + Select.

   6. Naviguez vers un produit de données tel qu’une table, une vue ou un autre produit de données.

      Vous pouvez également rechercher et choisir un produit de données à partager.

   7. Sélectionnez Done lorsque vous avez terminé.

   8. Sélectionnez Save.

2. Indiquez qui peut accéder à l’annonce (les comptes cibles, les rôles et les régions).

   1. Sélectionnez + Access Control. La boîte de dialogue Access and discovery apparaît.

   2. Complétez la section Grant access:

      Champ	Description
      Who can access this data product?	Sélectionnez l’un des éléments suivants : Entire organization : Toute personne dans l’organisation peut accéder à l’annonce. Si Entire organization est sélectionné et l”exécution automatique inter-cloud est activée sur votre compte, vous serez alors invité à vérifier les paramètres d’actualisation de l’exécution automatique de l’annonce. Selected accounts and roles : Seuls les comptes et rôles sélectionnés disposent d’un accès. No accounts or roles are pre-approved : (Par défaut) Le produit de données sera uniquement disponible sur demande
      Accounts	Si Selected accounts and roles est sélectionné, choisissez un ou plusieurs comptes. En option. Sélectionnez + Add another account pour ajouter un deuxième compte et les comptes suivants. Par défaut, tous les rôles des comptes sélectionnés peuvent accéder à l’annonce. Sélectionnez Selected roles pour accorder l’accès uniquement à des rôles spécifiques de chaque compte sélectionné.

   3. Complétez la section Allow discovery:

      Champ	Description
      Who else can discover the listing and request access?	Sélectionnez l’une des options suivantes : Entire organization : (Par défaut) Toute personne dans l’organisation peut découvrir une annonce et en demander l’accès. Ce champ est sélectionné et désactivé si Entire organization est spécifié dans la section Grant access. Selected accounts and roles : Seuls les comptes et rôles sélectionnés peuvent découvrir l’annonce et en demander l’accès. Not discoverable by users without access : Seuls les utilisateurs possédant un accès peuvent découvrir cette annonce.
      Accounts	Si Select accounts and roles est sélectionné, sélectionnez un ou plusieurs comptes. En option. Sélectionnez + Add another account pour ajouter un deuxième compte et les comptes suivants et accorder l’accès à des rôles spécifiques.
      Selected user roles	Si Selected roles est sélectionné, entrez un ou plusieurs rôles pour accorder l’accès.

   4. Si Allow discovery est Selected accounts and roles, sélectionnez alors Set up request approval flow.

      • Dans la liste Set up request approval flow, sélectionnez l’une des options suivantes dans la liste How should the request approval happen? :

        • Manage requests in Snowflake : Saisissez l’adresse e-mail de l’approbateur de la requête et indiquez éventuellement des rôles supplémentaires pouvant approuver les requêtes.

        • Manage requests outside of Snowflake : Saisissez une adresse e-mail pour l’approbateur de la requête ou saisissez une URL qui pointe vers un système de gestion des tickets internes.

        Note

        Le bouton Set up request approval flow n’est pas disponible si le produit de données est accessible par l’ensemble de l’organisation ou si le produit de données n’est pas découvrable par les utilisateurs sans accès.

3. Indiquez un titre et examinez le localisateur d’annonce uniforme généré (ULL).

   La modification du titre d’une annonce est facultative mais recommandée. Pour plus d’informations, voir Localisateur de listings uniformes.

   1. Sélectionnez Untitled Listing.

   2. Pour Listing title, saisissez un titre descriptif pour votre produit de données.

   3. Sélectionnez Save ou Cancel.

4. Complétez l’annonce.

   Saisissez des informations supplémentaires sur la page d’annonce pour guider les consommateurs, telles qu’une description, un`dictionnaire de données <http://other-docs.snowflake.com/en/collaboration/provider-listings-reference#label-listings-data-dictionaries>`_, des exemples d’utilisation, des attributs, etc.

   Notez que Support Contact est une exigence.

5. Sélectionnez Publish pour que l’annonce soit disponible dans le Internal Marketplace.

   Si vous quittez sans publier, l’annonce est enregistrée en tant que projet, prête à être révisée ou à recevoir des métadonnées descriptives.

Créez une annonce d’organisation à partir du partage avec les attributs requis inclus dans YAML (saisis dans les délimiteurs $$).

Cette partie du fichier manifeste yaml spécifie les comptes qui pourront utiliser l’annonce d’organisation :

organization_targets:
  access:

Cet exemple crée une annonce en utilisant les paramètres requis dans le YAML manifeste. Il cible un rôle dans un compte dans une région et inclut les contacts de support et d’approbation :

USE ROLE <organizational_listing_role>;

CREATE ORGANIZATION LISTING <organization_listing_name>
SHARE <share_name> AS
$$
title: "My title"
description: "One region, all accounts"
organization_profile: "INTERNAL"
organization_targets:
  discovery:
  - account: "<account_name>"
    roles:
    - "<role>"

  access:
  - account: "<account_name>"
    roles:
    - "<role>"

support_contact: "support@somedomain.com"
approver_contact: "approver@somedomain.com"
locations:
  access_regions:
  - name: "PUBLIC.<snowflake_region>"
$$;

Pour une liste complète de tous les champs et valeurs d’un listing d’organisations, voir Référence au manifeste de listing d’organisation. Pour d’autres exemples, voir Définir qui peut découvrir une annonce d’organisation et y accéder.