Notebooks privés¶

Conditions préalables à l’utilisation des notebooks privés¶

Avant de créer et d’utiliser des notebooks privés, un administrateur ayant le rôle ACCOUNTADMIN doit effectuer les tâches suivantes :

• Activer la fonction de base de données personnelle au niveau du compte ou pour des utilisateurs spécifiques.

  Les bases de données personnelles sont des objets de Snowflake qui permettent aux notebooks de se comporter comme des notebooks privés. Pour obtenir des informations sur l’exécution de cette tâche, reportez-vous aux sections suivantes :

  • Activer et désactiver les notebooks privés pour le compte

  • Activer et désactiver des notebooks privés pour les utilisateurs individuels

• Si nécessaire, définissez des rôles secondaires appropriés pour les utilisateurs qui vont créer des notebooks privés.

  Pour des informations sur l’achèvement de cette tâche, qui pourrait dépendre de l’activation des récents bundles BCR, voir Activer tous les rôles secondaires pour les utilisateurs du notebook privé.

Pour plus d’informations sur la création d’un notebook privé, voir Créer un nouveau notebook.

Activer tous les rôles secondaires pour les utilisateurs du notebook privé¶

Avant de créer un notebook privé, veillez à ce que tous les rôles secondaires soient activés. En effet, les notebooks privés appartiennent à l’utilisateur et non à son rôle principal.

Pour activer tous les rôles secondaires d’un utilisateur par défaut, l’utilisateur ou un administrateur peut utiliser la commande ALTER USER pour désactiver la propriété de l’objet DEFAULT_SECONDARY_ROLES ou lui attribuer la valeur (“ALL”) pour l’utilisateur.

Par exemple :

ALTER USER my_user UNSET DEFAULT_SECONDARY_ROLES;
ALTER USER my_user SET DEFAULT_SECONDARY_ROLES = ('ALL');

Après que l’utilisateur ou un administrateur a exécuté l’instruction SQL ci-dessus, l’utilisateur peut créer un notebook privé dans Snowsight (Projects » Notebooks) ou en exécutant des commandes SQL dans une nouvelle feuille de calcul.

Un utilisateur qui souhaite exécuter des commandes SQL dans une feuille de calcul existante doit exécuter l’instruction SQL suivante avant de créer un notebook privé :

USE SECONDARY ROLES ALL;

Activer et désactiver les notebooks privés pour le compte¶

Pour activer ou désactiver les notebooks privés sur un compte Snowflake, utilisez le paramètre ENABLE_PERSONAL_DATABASE.

Propriétés de ENABLE_PERSONAL_DATABASE :

Type:

Utilisateur — Peut être défini pour Compte > Utilisateur

Type de données:

Booléen

Description:

Détermine si les utilisateurs ont accès aux notebooks privés.

Valeurs:

TRUE : permet aux utilisateurs d’accéder à leurs bases de données personnelles.

FALSE : empêche les utilisateurs d’accéder à leurs bases de données personnelles.

Par défaut:

FALSE

ALTER ACCOUNT SET ENABLE_PERSONAL_DATABASE = TRUE;

ALTER ACCOUNT SET ENABLE_PERSONAL_DATABASE = FALSE;

SHOW PARAMETERS LIKE 'ENABLE_PERSONAL_DATABASE' IN ACCOUNT;

USE DATABASE USER$;

USE DATABASE USER$bobr;

USE DATABASE USER$jlap;

ERROR: Insufficient privileges to operate on database 'USER$JLAP'

Activer et désactiver des notebooks privés pour les utilisateurs individuels¶

Les administrateurs peuvent souhaiter que des utilisateurs spécifiques du compte aient un accès personnel à la base de données, plutôt que tous les utilisateurs du compte. Pour accorder l’accès à des utilisateurs donnés, utilisez la commande ALTER USER afin de définir le paramètre ENABLE_PERSONAL_DATABASE sur TRUE pour ces utilisateurs. Par exemple, autorisez l’accès à trois utilisateurs :

ALTER USER bobr SET ENABLE_PERSONAL_DATABASE = TRUE;
ALTER USER amya SET ENABLE_PERSONAL_DATABASE = TRUE;
ALTER USER jlap SET ENABLE_PERSONAL_DATABASE = TRUE;

Si vous activez les bases de données personnelles au niveau du compte, vous pouvez désactiver les bases de données personnelles pour les utilisateurs individuels, si nécessaire. Pour désactiver les utilisateurs, exécutez la même commande mais définissez le paramètre sur la valeur FALSE. Par exemple :

ALTER USER jlap SET ENABLE_PERSONAL_DATABASE = FALSE;

Si l’utilisateur jlap spécifie le préfixe USER$ dans une commande, la commande échouera car la base de données personnelle n’existe pas.

NotebookSqlException: Failed to fetch a pandas Dataframe. The error is: 060109 (0A000): Personal Database is not enabled for user JLAP.
Please contact an account administrator to enable it and try again.

Créer un notebook privé¶

Pour créer un notebook privé, procédez comme suit :

1. Connectez-vous à Snowsight.

2. Sélectionnez Projects » Notebooks dans le menu de navigation de gauche.

3. Sélectionnez + Notebook.

4. Sélectionnez votre nom d’utilisateur dans la liste Owner.

5. Saisissez un nom pour votre notebook.

   Note

   Si vous utilisez une région AWS, vous pouvez spécifier l’environnement d’exécution de votre notebook : Warehouse Runtime ou Container Runtime.

6. Sélectionnez un Notebook location. Il s’agit de la base de données et du schéma dans lesquels votre notebook sera stocké. Ce paramètre ne peut pas être modifié après la création du notebook. Si vous créez un notebook privé après l’activation des bases de données personnelles pour votre compte, votre base de données personnelle sera préremplie par défaut sous Notebook location. Toutefois, si vous créez un notebook privé et qu’il n’y a qu’un seul schéma dans votre base de données personnelle, les options Notebook location ne sont pas disponibles.

   Note

   Il se peut que la liste déroulante Notebook location n’affiche pas les bases de données créées après l’ouverture de la boîte de dialogue Create Notebook. Si vous ne trouvez pas la base de données, le schéma ou l’entrepôt que vous venez de créer, essayez de recharger la fenêtre de votre navigateur.

   La requête de données dans le notebook n’est pas limitée à cet emplacement. Dans le notebook, vous pouvez effectuer des requêtes sur les données de tous les emplacements auxquels vous avez accès. Pour spécifier l’emplacement, exécutez USE WAREHOUSE et USE SCHEMA.

7. Sélectionnez Run on warehouse ou Run on container comme environnement Python.

8. Facultatif Sélectionnez un Query warehouse pour exécuter n’importe quelle requête SQL ou Snowpark émise par le notebook.

9. Sélectionnez un Notebook warehouse pour exécuter des tâches spécifiques au notebook. Snowflake vous recommande d’utiliser SYSTEM$STREAMLIT_NOTEBOOK_WH, un entrepôt géré par Snowflake et provisionné dans chaque compte pour l’exécution de notebooks.

10. Sélectionnez Create pour créer et ouvrir votre notebook.

Organiser vos notebooks privés¶

Vous pouvez créer et utiliser des schémas pour organiser vos notebooks privés. Par défaut, les bases de données personnelles contiennent les schémas standard nommés PUBLIC et INFORMATION_SCHEMA.

Créez et utilisez de nouveaux schémas de la manière habituelle, mais assurez-vous que vous utilisez votre base de données personnelle lorsque vous créez des schémas. Par exemple :

USE DATABASE USER$bobr;
CREATE SCHEMA bobr_schema;
USE SCHEMA bobr_schema;

Vous pouvez également utiliser la commande ALTER SCHEMA sur les schémas des bases de données personnelles, et vous pouvez utiliser la commande SHOW SCHEMAS pour voir les schémas qui appartiennent aux bases de données personnelles. Par exemple :

ALTER SCHEMA bobr_schema RENAME TO bobr_personal_schema;
SHOW TERSE SCHEMAS;

+-------------------------------+----------------------+------+---------------+-------------+
| created_on                    | name                 | kind | database_name | schema_name |
|-------------------------------+----------------------+------+---------------+-------------|
| 2024-10-28 19:33:18.437 -0700 | BOBR_PERSONAL_SCHEMA | NULL | USER$BOBR     | NULL        |
| 2024-10-29 14:11:33.267 -0700 | INFORMATION_SCHEMA   | NULL | USER$BOBR     | NULL        |
| 2024-10-28 12:47:21.502 -0700 | PUBLIC               | NULL | USER$BOBR     | NULL        |
+-------------------------------+----------------------+------+---------------+-------------+

Rendre un notebook privé disponible pour usage général¶

À un moment donné de son développement, vous souhaiterez peut-être recréer votre notebook en dehors de votre base de données personnelle. Pour effectuer cette modification, dupliquez le notebook original à l’aide d’une commande CREATE NOTEBOOK. Lorsque vous faites cela, le notebook devient visible pour les autres utilisateurs.

Par exemple :

CREATE NOTEBOOK bobr_prod_notebook
  FROM 'snow://notebook/USER$BOBR.PUBLIC.bobr_private_notebook/versions/version$1/'
  QUERY_WAREHOUSE = 'PUBLIC_WH'
  MAIN_FILE = 'notebook_app.ipynb'
  COMMENT = 'Duplicated from personal database';

Notebook BOBR_PROD_NOTEBOOK successfully created.

Vous pouvez également créer un notebook privé à partir d’un notebook créé dans une base de données de production.

FROM 'source_location'

Indique que le notebook doit être créé à partir d’un fichier .ipynb se trouvant à l’emplacement spécifié dans la zone de préparation :

• Pour créer le notebook à partir d’un fichier dans une zone de préparation, définissez source_location sur l’emplacement de la zone de préparation du fichier et définissez le paramètre MAIN_FILE sur le nom du fichier.

• Pour créer le notebook à partir d’un notebook privé (par exemple, pour rendre un notebook privé disponible pour une utilisation partagée), définissez ce paramètre sur :

  'snow://notebook/USER$username.schema.notebook/versions/version$1/'

  Où :

  • username est votre nom d’utilisateur.

  • schema est le nom du schéma qui contient le notebook privé.

  • notebook est le nom du notebook privé.

Si ce paramètre n’est pas spécifié, l’objet du notebook est créé à partir d’un modèle de notebook.

Voir des informations sur les notebooks privés et les bases de données personnelles¶

Les utilisateurs individuels peuvent utiliser Snowsight pour voir les informations relatives à leurs notebooks. Allez à Projects » Notebooks. Le propriétaire du notebook est annoncé comme l’utilisateur.

Pour obtenir des informations sur les bases de données, y compris les bases de données personnelles, accédez à Data » Databases. Vous pouvez facilement voir quelles sont les bases de données personnelles car elles portent le préfixe USER$.

Visibilité de l’administrateur¶

Les rôles dotés du privilège MANAGE GRANTS ont une visibilité sur tous les objets du compte, y compris les objets personnels appartenant à des utilisateurs individuels. Par exemple, des rôles tels que ACCOUNTADMIN peuvent, par défaut, voir toutes les bases de données, y compris les bases de données personnelles. Ces rôles peuvent également accéder aux détails des schémas et des notebooks privés au sein des bases de données personnelles.

Pour visualiser les détails de toutes les bases de données personnelles d’un compte, effectuez une requête sur la vue DATABASES Account Usage :

SELECT * FROM SNOWFLAKE.ACCOUNT_USAGE.DATABASES;

Les administrateurs peuvent utiliser DESCRIBE NOTEBOOK pour voir les propriétés d’un notebook privé spécifique :

DESCRIBE NOTEBOOK USER$.PUBLIC.bobr_private_notebook;

Sur la page Projects » Notebooks de Snowsight, les administrateurs ne peuvent pas voir les objets de notebook privé qui appartiennent à d’autres utilisateurs figurant dans la liste Notebooks.

Pour afficher la base de données personnelle d’un utilisateur en cours :

SHOW DATABASES LIKE 'USER$BOBR';

Pour les bases de données personnelles, la valeur de la colonne kind est PERSONAL DATABASE.

Limitations¶