Template in Google Sheets

Le Databricks Connector for Google Sheets vous permet d’enregistrer un ensemble réutilisable d’importations sous forme de template dans Unity Catalog. Créez des templates à partir de vos importations enregistrées, organisez-les dans des groupes que vous partagez avec des utilisateurs spécifiques, et importez les query d’un template dans n’importe quelle feuille. Un Template stocke uniquement les définitions de query, et non les données importées ; ainsi, chaque personne qui l’utilise exécute les query avec ses propres autorisations Unity Catalog.

Cette page explique comment configurer, créer et gérer des Template. Pour importer des données à partir d'un template, consultez Choisir une méthode d'importation.

Configurer des Template

A Workspace admin or a user with the CREATE CATALOG privilege must set up Template in the Databricks Connector for Google Sheets :

1. Dans la barre latérale du connecteur, cliquez sur le Saved imports tab, puis sur l’icône Templates .

2. Saisissez un nom pour votre premier groupe de Template. Les groupes de Template organisent les Template associés.

3. Choisissez les utilisateurs autorisés à utiliser des templates dans le groupe :

   • Share with all account users : tout le monde dans le compte.
   • Partager avec des utilisateurs spécifiques : saisissez une ou plusieurs adresses e-mail.

4. Cliquez sur Setup Templates . This creates a spreadsheet_templates catalog and a gsheet_templates schema in your workspace's metastore, and grants SELECT on the new template group to the users you chose.

important

Le connecteur n'accorde que SELECT sur le groupe de Template. Pour que les utilisateurs puissent voir et importer des Template, un administrateur de Workspace doit également leur accorder USE CATALOG sur le catalogue spreadsheet_templates et USE SCHEMA sur le schéma gsheet_templates. Pour permettre aux utilisateurs de créer ou de modifier des Template, accordez également MODIFY sur le groupe de Template. Consultez la page Manage privileges in Unity Catalog.

Créer un groupe de Template

Une fois les Template configurés, tout utilisateur ayant accès au catalogue de Template et au schéma peut créer des groupes de Template. Pour créer ou modifier des Template dans un groupe, vous avez besoin de MODIFY sur ce groupe.

Les groupes de Template organisent les Template associés et contrôlent qui peut y accéder. Lorsque vous créez un groupe, vous choisissez quels utilisateurs peuvent utiliser les Template qu'il contient.

1. Dans l’onglet Saved imports tab, cliquez sur l’icône Template , puis sur + New Group .

2. Entrez un nom de groupe en utilisant des lettres, des chiffres et des traits de soulignement.

3. Choisissez qui peut utiliser le groupe :

   • Share with all account users : tout le monde dans le compte.
   • Partager avec des utilisateurs spécifiques : saisissez une ou plusieurs adresses e-mail.

4. Click Create group .

Créer un template

Créez un template à partir des importations déjà enregistrées dans votre classeur :

1. Dans l’tab Saved imports, cliquez sur l’icône Template, puis sur + New Template.
2. Sélectionnez un groupe de templates et saisissez un nom pour le template.
3. Select the saved imports to include.
4. Cliquez sur Créer un template .

Gérer les Template

Dans la vue Template , vous pouvez effectuer les actions suivantes :

• Développez un template pour voir les importations qu’il contient.
• Edit a template to add or remove imports.
• Supprimer un template.

La modification et la suppression d'un template nécessitent MODIFY sur le groupe de templates.

Limitations

• Vous pouvez ajouter des imports à un template ou en supprimer, mais vous ne pouvez pas modifier le texte de query enregistré à l'intérieur d'un template. Supprimez et recréez plutôt le template.
• Vous ne pouvez pas créer de Template à partir de l’interface utilisateur de Databricks ou des query enregistrées dans Databricks.

Ressources supplémentaires

• Query Databricks data in Google Sheets