Créer une annonce organisationnelle¶
Créez une annonce d’organisation pour partager des produits de données en toute sécurité au sein de votre organisation. Avant de créer une annonce d’organisation, passez en revue les conditions préalables, les limites connues et les points à prendre en considération.
Conditions préalables¶
Vous avez accès au rôle ORGADMIN (Comptes d’organisation est facultatif).
L’administrateur de votre organisation (ORGADMIN) a signé les conditions d’annonce.
Limitations connues¶
Cette fonction n’est pas disponible dans les régions gouvernementales.
Vous devez utiliser l’API pour cibler des régions spécifiques.
Produits de données pris en charge : Snowflake Native App Framework et actions.
Les fonctions suivantes ne sont pas prises en charge lors de l’utilisation des annonces d’organisation :
Créer des profils personnalisés.
Analyses du Marketplace.
Comptes de lecteur.
Considérations¶
Avant de cibler une organisation entière, vérifiez la présence de locataires externes. Ajustez les comptes cibles de vos produits de données avant de les ajouter à une annonce d’organisation, sauf si vous avez l’intention de les partager avec des locataires externes.
Chaque partage peut être rattaché à une seule annonce.
Chaque Native App peut être rattachée à une ou plusieurs annonces.
Pour les changements d’organisation (tels que les fusions) avec des comptes contenant des annonces d’organisation, contactez le support Snowflake.
Exigences en matière de contrôle d’accès¶
Utilisez les informations fournies ici pour déterminer les rôles et privilèges spécifiques dont vous devez disposer pour exécuter les commandes SQL d’annonce d’organisation.
CREATE ORGANIZATION LISTING¶
Un rôle utilisé pour exécuter cette opération doit au minimum disposer des privilèges suivants :
Privilège |
Objet |
Remarques |
---|---|---|
CREATE ORGANIZATION LISTING |
ACCOUNT |
Pour créer et modifier des annonces organisationnelles. |
CREATE DATA EXCHANGE LISTING |
ACCOUNT |
Pour créer et modifier des annonces organisationnelles. |
Un rôle utilisé pour exécuter cette commande SQL doit avoir au moins l’un des privilèges suivants définis au minimum ainsi :
Privilège |
Objet |
Remarques |
---|---|---|
USAGE |
SHARE |
Pour joindre le partage spécifié à une annonce. |
USAGE |
APPLICATION |
Pour joindre le Snowflake Native App Framework spécifié à une annonce. |
MANAGE LISTING AUTO FULFILLMENT¶
Un rôle utilisé pour exécuter cette opération doit au minimum disposer des privilèges suivants :
Privilège |
Objet |
Remarques |
---|---|---|
MANAGE LISTING AUTO FULFILLMENT |
ACCOUNT |
Pour configurer les paramètres de l’exécution automatique. |
Créer une annonce organisationnelle¶
Create an organizational listing.
Sign in to Snowsight.
Select Data Products » Provider Studio in the left-side navigation menu.
Click + Listing » Internal Marketplace.
Click + Data Product.
In the + Data Product dialog, click + Select.
Navigate to a data product such as a table, a view or other data product.
Alternatively, search for and choose a data product to share.
Select Done when complete.
Select Save.
Specify who can access the listing (the target accounts, roles, and regions).
Click + Access Control. The Access and discovery dialog displays.
In the Grant access section, enter values for the following:
Field
Description
Who can access this data product?
Select one of:
Entire organization Anyone in the organization can access the listing.
Selected accounts and roles Only selected accounts and roles can access.
No accounts or roles are pre-approved (Default) Data product will only be available by request.
Accounts
If Select accounts and roles is selected, select one or more accounts.
Click + Add another account to add second and subsequent accounts.
Selected user roles
If Selected roles is selected, enter one or more roles to grant access.
In the Allow discovery section, enter values for the following:
Field
Description
Who else can discover the listing and request access?
Select one of:
Entire organization (Default) Anyone in the organization can discover listing and request access.
Selected accounts and roles Only selected accounts and roles can discover listing and request access.
Not discoverable by users without access Only users with access can discover this listing.
Accounts
If Select accounts and roles is selected, select one or more accounts.
Click + Add another account to add second and subsequent accounts.
Selected user roles
If Selected roles is selected, enter one or more roles to grant access.
In the Request approval section, enter the email address of the request approver or link to the internal ticketing system.
Indiquez le titre et le localisateur d’annonce uniforme (ULL).
La modification du titre d’une annonce est facultative mais recommandée. Voir Localisateur d’annonce uniforme pour plus d’informations.
Sélectionnez Untitled Listing.
Pour Listing title, saisissez un titre descriptif pour votre produit de données.
Sélectionnez Save ou Cancel.
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, des exemples d’utilisation, etc.
Notez que Support Contact est une exigence
Cliquez sur 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 :
Note
support_contact
est obligatoire. approver_contact
est obligatoire si une cible discovery
est fournie.
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 d’autres exemples, voir Définir qui peut découvrir une annonce d’organisation et y accéder.