Paramètres d'administration - Explorations en libre-service

La fonctionnalité Explores en libre-service permet à vos utilisateurs Looker d'importer des fichiers CSV, XLS et XLSX dans Looker, puis d'interroger et de visualiser les données dans un Explore Looker sans avoir à configurer un modèle LookML ni à configurer le contrôle des versions Git.

Les administrateurs Looker peuvent sélectionner l'option Explorations en libre-service dans le menu Admin de Looker pour configurer la fonctionnalité Explorations en libre-service et afficher les importations de données dans l'instance.

Avant de commencer

Pour utiliser les explorations en libre-service, votre instance Looker doit répondre aux exigences suivantes :

Exécuter Looker 25.18 ou version ultérieure.
Il doit être connecté à une base de données BigQuery (consultez la page de documentation Google BigQuery pour savoir comment configurer une connexion BigQuery sur votre instance Looker). La connexion doit être configurée comme suit :
- La connexion doit être configurée avec le champ d'application Tous les projets. Pour vérifier le champ d'application de la connexion, consultez la colonne Champ d'application de l'onglet Bases de données de la page Connexions du menu d'administration de Looker. Une fois la connexion créée, la valeur de son champ d'application du projet ne peut plus être modifiée.
- La connexion doit être activée pour les tables dérivées persistantes (PDT). Pour vérifier que les PDT sont activées sur la connexion BigQuery, ouvrez la page Connexions de Looker, cliquez sur le bouton Modifier pour la connexion BigQuery, cliquez pour ouvrir l'onglet Paramètres facultatifs, puis vérifiez que l'option Activer les PDT est activée.
Pour tout utilisateur qui créera des explorations en libre-service, son compte utilisateur Looker doit disposer de l'autorisation upload_data, qui lui permet d'importer des fichiers CSV dans votre instance.

Activer les explorations en libre-service

Important :

Pour prendre en charge la fonctionnalité Explorer en libre-service, votre instance Looker ajoute l'autorisation upload_data à tout rôle ou ensemble d'autorisations contenant l'autorisation explore, y compris les ensembles d'autorisations personnalisés, lorsque vous passez à Looker 25.20. Si vous activez l'importation de données dans une instance Looker, tout utilisateur disposant de l'autorisation upload_data pourra importer des données pour créer des explorations en libre-service dans votre instance.
Faites attention lorsque vous modifiez les paramètres sur la page d'administration Explorations en libre-service si votre instance comporte des explorations en libre-service existantes :
- Si vous désactivez l'importation de données, vos utilisateurs ne pourront plus accéder aux explorations en libre-service existantes depuis le menu Explorer. Les Looks ou tableaux de bord qui s'appuient sur les données pourront également être affectés.
- Si vous modifiez la connexion BigQuery, cela peut affecter les explorations en libre-service existantes sur votre instance, ainsi que les Looks ou les tableaux de bord qui s'appuient sur leurs données.

Avant que vos utilisateurs puissent créer des explorations en libre-service, un administrateur Looker doit configurer la fonctionnalité en procédant comme suit :

Dans la section Général du menu Admin de Looker, sélectionnez la page d'administration Explorations en libre-service.
Sur la page d'administration Explores en libre-service, dans le menu déroulant Connexion BigQuery par défaut, sélectionnez la connexion BigQuery à utiliser pour stocker les données des Explorations en libre-service. Looker enregistre les données dans cette base de données BigQuery pour les explorations en libre-service de votre instance.
Cliquez sur le bouton Tester la connexion pour vérifier que la connexion BigQuery est valide et que les PDT sont activées afin de permettre l'importation de données. (Pour en savoir plus sur les exigences concernant les connexions permettant d'importer des données, consultez la section Avant de commencer.) Si le test échoue, vous ne pourrez pas activer les importations de données. Vous pouvez accéder à la page d'administration Connexions pour en savoir plus sur votre connexion et tester la connexion afin de déterminer où elle échoue.
Cliquez sur le bouton Activer les importations de données.
Si vous souhaitez que votre instance Looker soit compatible avec l'importation de données depuis Google Sheets, vous devez également utiliser la console Google Cloud pour activer les API requises. Consultez la section Activer les API pour prendre en charge les importations Google Sheets sur cette page.

Activer les API pour prendre en charge les importations Google Sheets

Pour permettre l'importation de données depuis Google Sheets, les API suivantes doivent être activées dans la console Google Cloud par un utilisateur IAM disposant de l'autorisation IAM roles/serviceusage.serviceUsageAdmin :

Cette API doit être activée dans le projet Google Cloud qui héberge la connexion BigQuery spécifiée dans le menu déroulant Connexion BigQuery par défaut de la page d'administration Explores en libre-service :
- API BigQuery : requise pour toutes les opérations BigQuery
Ces API doivent être activées dans le projet Google Cloud associé au compte de service utilisé pour importer les données (le compte de service utilisé pour les processus PDT sur votre connexion BigQuery, qui peut être le même que le projet Google Cloud spécifié dans le menu déroulant Connexion BigQuery par défaut de la page d'administration Explorations en libre-service) :
- API BigQuery : requise pour toutes les opérations BigQuery
- API Google Sheets : requise pour récupérer le nom de chaque feuille d'un document Google Sheets
- API Google Drive : requise pour que BigQuery puisse lire les fichiers Drive

Pour activer les API, procédez comme suit :

Dans la console Google Cloud , ouvrez le sélecteur de projet, puis sélectionnez le projet qui héberge la connexion BigQuery spécifiée dans le menu déroulant Connexion BigQuery par défaut de la page d'administration Explores en libre-service.
Dans le menu de navigation de la console Google Cloud , accédez à API et services > Bibliothèque, puis ouvrez l'API BigQuery.

Accéder à l'API BigQuery
Sur la page de l'API BigQuery, si l'API n'est pas déjà activée, cliquez sur Activer.
Toujours sur la page de l'API BigQuery, dans la console Google Cloud , ouvrez le sélecteur de projet, puis sélectionnez le projet Google Cloud associé au compte de service utilisé pour importer les données (le compte de service utilisé pour les processus PDT sur votre connexion BigQuery).
Sur la page de l'API BigQuery, si l'API n'est pas déjà activée, cliquez sur Activer.
Dans le menu de navigation de la console Google Cloud , accédez à API et services > Bibliothèque, puis ouvrez l'API Google Sheets.

Accéder à l'API Google Sheets
Sur la page de l'API Google Sheets, si l'API n'est pas déjà activée, cliquez sur Activer.
Dans le menu de navigation de la console Google Cloud , accédez à API et services > Bibliothèque, puis ouvrez l'API Google Drive.

Accéder à l'API Google Drive
Sur la page de l'API Google Drive, si l'API n'est pas déjà activée, cliquez sur Activer.

Activer OAuth pour les importations Google Sheets

Une fois que vous avez activé les explorations en libre-service et activé les API pour permettre l'importation de fichiers Google Sheets, vous pouvez également autoriser vos utilisateurs à utiliser la navigation Google Drive pour sélectionner des documents Google Sheets à importer.

Pour activer la navigation Google Drive sur votre instance Looker, un utilisateur IAM disposant des rôles requis doit créer un client OAuth dans la console Google Cloud , puis saisir les identifiants OAuth sur la page d'administration Explorations en libre-service de votre instance Looker, comme décrit dans la procédure de cette section.

Pour créer le client OAuth et saisir les identifiants dans votre instance Looker, procédez comme suit :

Dans la console Google Cloud , utilisez le sélecteur de projet de la console Google Cloud pour sélectionner le projet Google Cloud associé au compte de service utilisé pour importer les données (le compte de service utilisé pour les processus PDT sur votre connexion BigQuery).

Accéder à la console Google Cloud
Dans le menu principal de la console Google Cloud , accédez à API et services > Identifiants.
Sur la page Identifiants, cliquez sur le menu déroulant Créer des identifiants, puis sélectionnez ID client OAuth.
Dans le menu déroulant Type d'application, sélectionnez Application Web.
Dans le champ Nom, saisissez un nom pour votre client OAuth, tel que Looker upload data from Sheets.
Dans la section Origines JavaScript autorisées, cliquez sur le bouton Ajouter un URI. Saisissez l'URL de votre instance Looker :
```
https://LOOKER_INSTANCE_URL
```
Cliquez sur Créer.
Après avoir cliqué sur Créer, une fenêtre Client OAuth créé s'affiche. Cette fenêtre affiche l'ID client et le code secret du client que la console Google Cloud a créés pour votre client OAuth. Copiez ces valeurs et notez-les.
Dans votre instance Looker, sélectionnez Explorations en libre-service dans la section Général du panneau Admin.
Sur la page Explorations en libre-service, dans les champs ID client et Code secret du client, collez les valeurs que vous avez copiées depuis la console Google Cloud lorsque vous avez créé le client OAuth dans la console Google Cloud .
Cliquez sur Enregistrer.

Désormais, lorsque vos utilisateurs importent des données à l'aide de l'option Importer depuis le cloud, Looker affiche la navigation Google Drive pour sélectionner les documents Google Sheets.

Afficher les importations de données dans votre instance Looker

Si les explorations en libre-service sont activées sur votre instance, un administrateur Looker peut utiliser le tableau Importations de données sur la page d'administration Explorations en libre-service pour afficher les données que vos utilisateurs ont importées sur l'instance.

Le tableau Importations de données affiche les informations suivantes sur les importations de données dans votre instance :

Nom de l'exploration en libre-service, qui est également un lien hypertexte permettant d'ouvrir l'exploration en libre-service
Propriétaire de l'importation de données
Date à laquelle les données ont été importées
Un bouton Supprimer qui permet aux administrateurs Looker de supprimer le fichier importé et l'exploration en libre-service associée

Les administrateurs Looker peuvent ouvrir n'importe quelle exploration en libre-service sur l'instance en utilisant les liens du tableau Importations de données. Toutefois, la section Explores en libre-service du menu Explorer de Looker ne liste que les Explorers en libre-service dont vous êtes le propriétaire ou que le propriétaire a spécifiquement partagés avec vous. Le menu Explorer ne liste pas toutes les explorations en libre-service de l'instance pour les administrateurs Looker, car cela pourrait rendre le menu Explorer difficile à utiliser.

Supprimer une importation de données

Le propriétaire d'une importation de données peut supprimer son importation de la page Modifier l'exploration en libre-service. De plus, un administrateur Looker peut supprimer un import de données de la page d'administration Explorations en libre-service en procédant comme suit :

Dans la section Général du menu Admin de Looker, sélectionnez la page d'administration Explorations en libre-service.
Dans le tableau Importations de données, cliquez sur le bouton Supprimer pour l'importation de données que vous souhaitez supprimer.
Cliquez sur Copier dans la boîte de dialogue de confirmation.