Référence du manifeste d’une Declarative Native App¶

champ application_content.notebooks.{named notebook}¶

Chaque notebook nommé prend en charge les paires nom/valeur suivantes :

• main_file (chaîne, obligatoire) le chemin d’accès au fichier de notebook interactif Python (.ipynb), relatif à la racine de la version du paquet.

• comment (chaîne, facultatif) : Un commentaire décrivant le notebook.

• runtime_environment_version (chaîne, facultatif) : Spécifie une version de l’environnement d’exécution spécifique pour le contexte d’exécution du notebook , le cas échéant dans la plateforme.

• roles (liste, facultatif) : Une liste des rôles de l’application qui peuvent accorder l’accès au notebook, par exemple, [sales,marketing]. Lorsque ce champ est vide ([]) ou omis, alors uniquement les propriétaires d’application et les rôles avec des IMPORTED PRIVILEGES autorisés reçoivent l’accès. Les rôles inclus doivent être définis dans le champ des rôles de niveau supérieur.

application_content:
    notebooks:
        - salesbook:
              roles: [sales, marketing]
              main_file: NOTEBOOK1.ipynb
              comment: Notebook1: Sales and marketing notebook
              runtime_environment_version: stable

roles:
  - sales:
  - marketing:

Exemple roles¶

roles:
  - sales:
  - marketing:

application_content:
  notebooks:
    - salesbook:
        roles: [sales, marketing]
        main_file: NOTEBOOK1.ipynb
        comment: Sales and marketing notebook

shared_content:
  databases:
    - sales:
        schemas:
          - orders:
              roles: [sales, marketing]
              tables:
                - january_2025:        # App owners/assignees only
                - february_2025:
                    roles: [sales]     # Accessible to sales only
                - march_2025:
                    roles: [marketing] # Accessible to marketing only
    - customer_info:
        schemas:
          - customer_contact:
              roles: [customer_support]
              views:
                - customer_address:
                    roles: [customer_support] # Accessible to customer_support
                - customer_details:
                    roles: []                 # App owners/assignees only

Pour plus d’informations sur les rôles, consultez les rôles d’application.

champ shared_content.databases.{named database}¶

Chaque base de données nommée prend en charge les paires nom/valeur suivantes :

• schemas (liste, obligatoire) : Une liste des schémas de la base de données.

champ shared_content.required_databases.{named database}¶

Le champ required_databases (liste, facultatif) définit une liste de bases de données qui sont des dépendances des bases de données partagées. Ces bases de données sont référencées par des vues dans les bases de données partagées, mais ne sont pas partagées directement. Pour plus d’informations sur la gestion des dépendances entre bases de données, consultez Bases de données de dépendances : Gestion des références entre bases de données.

Lorsque votre application partage des données provenant de plusieurs bases de données, vous devez explicitement lister toutes les bases de données supplémentaires qui sont référencées par des objets dans votre contenu partagé dans le champ bases_données_requises. Cela garantit que l’application peut être déployée avec succès dans d’autres régions où ces bases de données peuvent ne pas exister par défaut.

Inclure une base de données dans required_databases est similaire au référencement d’une base de données à l’aide du privilège REFERENCE_USAGE dans le partage de données sécurisé traditionnel. Pour plus d’informations sur le privilège REFERENCE_USAGE et la façon dont les bases de données dépendantes sont partagées dans le partage de données traditionnel, voir Partager des données de plusieurs bases de données.

champ schemas.{named schema}¶

Chaque schéma nommé prend en charge les paires nom/valeur suivantes :

• tables (liste, [OneOfRequired]): Une liste de tables nommées, qui peut inclure des tables dynamiques et des tables Apache Iceberg.

• views (liste, [OneOfRequired]): Une liste de vues nommées.

• semantic_views (liste, [OneOfRequired]): Une liste de vues sémantiques nommées.

• functions (liste, [OneOfRequired]): Une liste de fonctions nommées définies par l’utilisateur (UDFs).

• procedures (liste, [OneOfRequired]): Une liste de procédures stockées nommées.

• cortex_agents (list, [OneOfRequired]): A list of named Cortex Agents.

• roles (liste, facultatif) : Une liste des rôles d’application que les objets du schéma peuvent utiliser, par exemple, [sales,marketing]. Lorsque ce champ est vide ([]) ou omis, alors uniquement les propriétaires d’application et les rôles avec des IMPORTED PRIVILEGES autorisés reçoivent l’accès. Les rôles inclus doivent être définis dans le champ des rôles de niveau supérieur.

champ tables.{named table}¶

Chaque table standard nommée, table dynamique, et Table Apache Iceberg (Liste, obligatoire [OneOfRequired] ) prend en charge la paire nom/valeur suivante :

• roles (liste, facultatif) : Une liste des rôles d’application qui peuvent accéder à la table, par exemple, [sales]. Lorsque ce champ est vide ([]) ou omis, alors uniquement les propriétaires d’application et les rôles avec des IMPORTED PRIVILEGES autorisés reçoivent l’accès. Les rôles inclus doivent être définis dans le champ des rôles de niveau supérieur et inclus dans le champ {schéma nommé}.roles.

champ views.{named view}¶

Chaque vue nommée (liste, obligatoire [OneOfRequired] ) : prend en charge la paire nom/valeur suivante :

• roles (liste, facultatif) : Une liste des rôles d’application qui peuvent accéder à la vue, par exemple, [marketing]. Lorsque ce champ est vide ([]) ou omis, alors uniquement les propriétaires d’application et les rôles avec des IMPORTED PRIVILEGES autorisés reçoivent l’accès. Les rôles inclus doivent être définis dans le champ des rôles de niveau supérieur et inclus dans le champ {schéma nommé}.roles.

champ semantic_views.{named semantic view}¶

Chaque vue sémantique nommée (liste, obligatoire [OneOfRequired] ) : prend en charge la paire nom/valeur suivante :

• roles (liste, facultatif) : Une liste des rôles d’application qui peuvent accéder à la vue sémantique, par exemple, [sales]. Notez que, lors du partage d’une vue sémantique, ses tables ou vues référencées doivent également être partagées. Lorsque ce champ est vide ([]) ou omis, alors uniquement les propriétaires d’application et les rôles avec des IMPORTED PRIVILEGES autorisés reçoivent l’accès. Les rôles inclus doivent être définis dans le champ des rôles de niveau supérieur et inclus dans le champ {schéma nommé}.roles.

champ functions.{named function}¶

Chaque fonction nommée (liste, obligatoire [OneOfRequired] ): prend en charge la paire nom/valeur suivante :

• roles (liste, facultatif) : Une liste des rôles d’application qui peuvent accéder à la fonction, par exemple, [analyst]. Lorsque ce champ est vide ([]) ou omis, alors uniquement les propriétaires d’application et les rôles avec des IMPORTED PRIVILEGES autorisés reçoivent l’accès. Les rôles inclus doivent être définis dans le champ des rôles de niveau supérieur et inclus dans le champ {schéma nommé}.roles.

champ procedures.{named procedure}¶

Chaque procédure stockée nommée (liste, obligatoire [OneOfRequired] ): prend en charge la paire nom/valeur suivante :

• roles (liste, facultatif) : Une liste des rôles d’application qui peuvent accéder à la procédure, par exemple, [analyst]. Lorsque ce champ est vide ([]) ou omis, alors uniquement les propriétaires d’application et les rôles avec des IMPORTED PRIVILEGES autorisés reçoivent l’accès. Les rôles inclus doivent être définis dans le champ des rôles de niveau supérieur et inclus dans le champ {schéma nommé}.roles.

cortex_agents.{named cortex agent} field¶

Each named Cortex Agent (List, required [OneOfRequired] ): supports the following name value pair:

• roles (list, optional): A list of app roles that can access the Cortex Agent; for example, [app_user]. When this field is empty ([]) or omitted, then only app owners and roles with granted IMPORTED PRIVILEGES receive access. The included roles must be defined in the top-level roles field and included in the {named schema}.roles field.

Exemple shared_content¶

Dans cet exemple, deux bases de données sont exposées : ventes et info_client. Dans ces bases de données, les tables orders.[january_2025|february_2025] sont exposées ainsi que la vue customer_contact.customer_address.

Deux bases de données requises sont également exposées : sales_projections et customer_analytics. Ces bases de données peuvent être référencées par des vues dans les bases de données partagées, mais elles ne sont pas partagées directement.

roles:
  - sales:
  - marketing:

shared_content:
  required_databases:
    sales_projections
    customer_analytics
  databases:
    - sales:
        schemas:
          - orders:
              roles: [sales, marketing]
              tables:
                - january_2025:        # App owners/assignees only
                - february_2025:
                    roles: [sales]     # Accessible to sales only
                - march_2025:
                    roles: [marketing] # Accessible to marketing only
    - customer_info:
        schemas:
          - customer_contact:
              roles: [customer_support]
              views:
                - customer_address:
                    roles: [customer_support] # Accessible to customer_support
                - customer_details:
                    roles: []                 # App owners/assignees only