Configuration des Snowflake Notebooks¶

Emplacement¶

L’emplacement est l’endroit où l’objet notebook est stocké. L’utilisateur final peut effectuer des requêtes dans toutes les bases de données et tous les schémas auxquels son rôle lui donne accès.

• Pour passer à une autre base de données ou à un autre schéma, utilisez les commandes USE DATABASE ou USE SCHEMA dans une cellule SQL.

Dans l’environnement d’exécution du conteneur, le rôle qui crée le notebook a également besoin du privilège CREATE SERVICE sur le schéma.

Les rôles qui possèdent un schéma ont automatiquement le privilège de créer des notebooks dans ce schéma, car les propriétaires peuvent créer n’importe quel type d’objet, y compris des notebooks.

Permettre à chacun de créer des notebooks dans un emplacement spécifique¶

Les étapes suivantes expliquent comment configurer l’accès pour la création de notebooks dans un emplacement spécifique en accordant l’utilisation d’une base de données et d’un schéma. Vous pouvez également activer les notebooks privés, qui ne requièrent pas de telles autorisations d’accès. Pour plus d’informations sur les notebooks privés, voir Notebooks privés.

Remplacez <database> et <database.schema> par la base de données et le schéma spécifiques dans lesquels vous souhaitez créer vos notebooks :

----------------------------------
--       Location Setup         --
----------------------------------
GRANT USAGE ON DATABASE <database> TO ROLE PUBLIC;
GRANT USAGE ON SCHEMA <database.schema> TO ROLE PUBLIC;
GRANT CREATE NOTEBOOK ON SCHEMA <database.schema> TO ROLE PUBLIC;

-- For Notebooks on Container runtime, run the following:
GRANT CREATE SERVICE ON SCHEMA <database.schema> TO ROLE PUBLIC;

----------------------------------
--    Compute Resource Setup    --
----------------------------------
GRANT USAGE ON WAREHOUSE <warehouse> TO ROLE PUBLIC;

-- For Notebooks on Container runtime:
CREATE COMPUTE POOL CPU_XS
  MIN_NODES = 1
  MAX_NODES = 15
  INSTANCE_FAMILY = CPU_X64_XS;

CREATE COMPUTE POOL GPU_S
  MIN_NODES = 1
  MAX_NODES = 5
  INSTANCE_FAMILY = GPU_NV_S;

GRANT USAGE ON COMPUTE POOL CPU_XS TO ROLE PUBLIC;
GRANT USAGE ON COMPUTE POOL GPU_S TO ROLE PUBLIC;

-------------------------------------
-- Optional: External Access --
-------------------------------------

-- Example EAI
CREATE OR REPLACE NETWORK RULE allow_all_rule
MODE = 'EGRESS'
TYPE = 'HOST_PORT'
VALUE_LIST = ('0.0.0.0:443','0.0.0.0:80');

CREATE OR REPLACE EXTERNAL ACCESS INTEGRATION allow_all_integration
ALLOWED_NETWORK_RULES = (allow_all_rule)
ENABLED = true;

GRANT USAGE ON INTEGRATION allow_all_integration TO ROLE PUBLIC;

Créer un rôle dédié¶

Si vous souhaitez que seuls des utilisateurs spécifiques puissent créer des notebooks (en supposant qu’ils ne OWN pas déjà des schémas), vous pouvez créer un rôle dédié pour contrôler l’accès. Par exemple :

CREATE ROLE notebooks_rl;

Accorder ROLE notebook_rl à des utilisateurs spécifiques. Ensuite, utilisez le script ci-dessus pour créer des ressources et accorder des autorisations à ce rôle (remplacez ROLE PUBLIC par ROLE notebook_rl).

Moteur du notebook¶

Le moteur du notebook (« noyau ») et les processus Python s’exécutent sur l’entrepôt du notebook. Snowflake vous recommande de commencer par un entrepôt X-Small afin de minimiser la consommation de crédit.

Pendant que vous utilisez le notebook (par exemple, pour modifier du code, exécuter, réorganiser ou supprimer des cellules), ou si le notebook reste actif pendant son délai d’expiration, une requête EXECUTE NOTEBOOK est exécutée en permanence pour indiquer que le moteur du notebook est actif et qu’une session de notebook est en cours d’utilisation. Vous pouvez vérifier le statut de cette requête sur Query history. Lorsque le site EXECUTE NOTEBOOK est en cours d’exécution, l’entrepôt du notebook est également en cours d’exécution. À la fin de EXECUTE NOTEBOOK, s’il n’y a pas d’autres requêtes ou jobs en cours dans l’entrepôt, celui-ci s’arrêtera conformément à sa politique de suspension automatique.

Pour mettre fin à la requête EXECUTE NOTEBOOK (terminer la session du notebook), procédez comme suit :

1. Sélectionnez Active ou sélectionnez End session dans le menu déroulant Active.

2. Dans Query history, trouvez la requête EXECUTE NOTEBOOK correspondante et sélectionnez Cancel query.

3. Laissez le notebook s’éteindre pour cause d’inactivité en fonction de son paramètre de temps d’inactivité. Si les paramètres STATEMENT_TIMEOUT_IN_SECONDS et STATEMENT_QUEUED_TIMEOUT_IN_SECONDS de l’entrepôt de du notebook sont définis sur une petite valeur, le notebook risque de s’éteindre rapidement ou de ne pas démarrer, quelle que soit l’activité de l’utilisateur.

Requêtes¶

Les requêtes SQL et Snowpark (par exemple, session.sql) sont poussées vers l’entrepôt de requêtes, qui est utilisé à la demande. Lorsque les requêtes SQL et Snowpark ont fini de s’exécuter, l’entrepôt de requêtes est suspendu si aucun autre job n’est en cours d’exécution en dehors du notebook. Sélectionnez la taille de l’entrepôt qui correspond le mieux à vos besoins en matière de performance des requêtes. Par exemple, vous pourriez vouloir exécuter des requêtes SQL volumineuses ou effectuer des opérations de calcul intensif à l’aide de Snowpark Python qui nécessitent un entrepôt plus important. Pour les opérations qui nécessitent une utilisation importante de la mémoire, envisagez d’utiliser un entrepôt optimisé par Snowpark.

Vous pouvez modifier l’entrepôt de requêtes dans Notebook Settings. Vous pouvez également exécuter la commande suivante dans n’importe quelle cellule SQL du notebook pour modifier l’entrepôt de requêtes pour toutes les requêtes ultérieures dans la session actuelle du notebook :

USE WAREHOUSE <warehouse_name>;

Temps d’inactivité et reconnexion¶

Chaque notebook possède une propriété de temps d’inactivité appelée IDLE_AUTO_SHUTDOWN_TIME_SECONDS dont la valeur par défaut est de 30 minutes. Vous pouvez configurer le temps d’inactivité pour chaque notebook dans l”Snowsight.

1. Connectez-vous à Snowsight.

2. Sélectionnez Projects » Notebooks.

3. Sélectionnez le menu des trois points de suspension verticaux pour configurer une nouvelle heure.

4. Sélectionnez Notebook settings.

5. Redémarrez manuellement la session pour que le nouveau délai d’inactivité prenne effet.

Le temps d’inactivité s’accumule chaque fois qu’il n’y a pas d’activité de la part de l’utilisateur, telle que l’édition de code, l’exécution de cellules, la réorganisation de cellules ou la suppression de cellules. Chaque fois que vous reprenez une activité, le temps d’inactivité se réinitialise. Lorsque le temps d’inactivité atteint le paramètre de délai d’expiration, la session du notebook s’arrête automatiquement.

Avant le délai d’expiration, votre session notebook restera active jusqu’à ce que la période de délai d’expiration soit atteinte, même si vous actualisez la page, visitez d’autres parties de l”Snowsight ou éteignez ou mettez en veille votre ordinateur. Lorsque vous rouvrez le même notebook, vous vous reconnectez à la même session, tous les états et variables de la session étant préservés, ce qui vous permet de continuer à travailler en toute transparence. Notez toutefois que l’état de vos widgets Streamlit ne sera pas conservé.

Chaque utilisateur utilisant le même notebook a sa propre session indépendante. Ils n’interfèrent pas les uns avec les autres.

Recommandations pour l’optimisation des coûts¶

En tant qu’administrateur de compte, tenez compte des recommandations suivantes pour contrôler le coût de fonctionnement des notebooks :

• Demandez à vos équipes d’utiliser le même entrepôt (X-Small est recommandé) comme « entrepôt du notebook » dédié à l’exécution des sessions du notebook afin d’augmenter la simultanéité. Notez que cela peut conduire à des démarrages de session plus lents (file d’attente sur l’entrepôt) ou à des erreurs de mémoire si un trop grand nombre de notebooks doivent être exécutés simultanément.

• Permettez à vos équipes d’utiliser un entrepôt dont la valeur STATEMENT_TIMEOUT_IN_SECONDS est plus faible pour exécuter des notebooks. Ce paramètre de l’entrepôt contrôle la durée des requêtes, y compris les sessions des notebooks. Par exemple, si le paramètre est défini sur 10 minutes, la session du notebook peut durer au maximum 10 minutes, que l’utilisateur soit ou non actif dans la session du notebook pendant cette période.

• Demandez à vos équipes de mettre fin à leurs sessions de notebook lorsqu’elles n’ont pas l’intention de travailler activement au cours de la session.

• Demandez à vos équipes de réduire le paramètre de délai d’expiration (par exemple, à 15 minutes) si elles n’ont pas besoin que la session se poursuive pendant une période prolongée.

• Vous pouvez également envoyer un ticket d’assistance pour définir une valeur par défaut pour le temps d’inactivité qui s’applique à l’ensemble de votre compte. Cette valeur peut encore être remplacée au niveau du notebook par le propriétaire du notebook.