Oracle

Vous pouvez configurer Looker pour analyser les données stockées dans votre base de données Oracle. L'intégration d'Oracle à Looker fournit une connexion sécurisée, accepte les tables dérivées persistantes (PDT) et facilite l'arrêt des requêtes. Grâce à cette intégration, vous pouvez utiliser vos données Oracle directement dans la plate-forme Looker pour répondre à vos besoins d'analyse et d'exploitation.

Remarque : La compatibilité de Looker avec Oracle est implémentée à l'aide de déploiements Oracle standards. Si votre base de données Oracle est un déploiement Oracle RAC, Looker peut s'y connecter. Toutefois, Looker peut rencontrer des problèmes lors de l'annulation des requêtes en raison d'une différence de métadonnées pour récupérer les ID de connexion des requêtes à partir des nœuds.

Chiffrement du trafic réseau

Il est recommandé de chiffrer le trafic réseau entre l'application Looker et votre base de données. Pour ce faire, consultez les options détaillées sur la page Sécurisation de l'accès à la base de données de la documentation.

Si vous envisagez d'utiliser le chiffrement SSL, consultez la documentation Oracle.

Créer un utilisateur Looker

Commencez par créer un utilisateur Looker désigné :

-- connect / as sysdba;
CREATE USER LOOKER IDENTIFIED BY <password>
DEFAULT TABLESPACE USERS
TEMPORARY TABLESPACE TEMP;

Ensuite, donnez au nouvel utilisateur Looker la possibilité de créer des sessions :

GRANT CREATE SESSION TO LOOKER;

Enfin, accordez à l'utilisateur Looker les autorisations SELECT appropriées pour les tables de données auxquelles vous prévoyez d'accéder depuis Looker. Si vous souhaitez accéder à d'autres tables à l'avenir, vous devrez également accorder SELECT sur ces nouvelles tables.

GRANT SELECT ON -- <all tables that will be used by looker>;

S'assurer que Looker peut voir toutes les tables

Looker peut ne pas être en mesure d'identifier les tables (en particulier les tables vides) sans collecter au préalable des statistiques dans Oracle. Si les tables dont vous avez besoin n'apparaissent pas dans le LookML généré ou dans l'exécuteur SQL, essayez d'exécuter la commande suivante :

EXEC DBMS_STATS.GATHER_DATABASE_STATS;

Pour découvrir d'autres méthodes, consultez la documentation Oracle.

Configurer les objets de base de données principaux

Votre administrateur de base de données Oracle doit configurer les objets et autorisations suivants sur Oracle. Les commandes suivantes créent LOOKER_SESSION et LOOKER_SQL en tant que synonymes de V$SESSION et V$SQL.

Exécutez les commandes suivantes en tant qu'utilisateur racine pour terminer cette configuration. Ces exemples supposent que le nom de l'utilisateur Looker est LOOKER.

CREATE OR REPLACE VIEW LOOKER_SQL
AS
  SELECT
    sql.SQL_ID,
    sql.SQL_TEXT
  FROM
    V$SQL sql,
    v$session sess
  WHERE
    sess.SQL_ADDRESS = sql.ADDRESS AND
    sess.username='LOOKER';

CREATE OR REPLACE SYNONYM LOOKER.LOOKER_SQL FOR LOOKER_SQL;

GRANT SELECT ON LOOKER.LOOKER_SQL TO LOOKER;

-- Pay special attention to the following comments:
-- the following view will be different for clustered Oracle deployments
CREATE OR REPLACE VIEW LOOKER_SESSION
AS
  SELECT
    SID,
    USERNAME,
    TYPE,
    STATUS,
    SQL_ID,
    -- If using a single node Oracle deployment
    "SERIAL#",
    -- If using a clustered Oracle deployment, like Oracle Real Application Clusters
    (SERIAL# || ',' || INST_ID) AS "SERIAL#",
    AUDSID
  -- If using a single node Oracle deployment
  FROM V$SESSION
  -- If using a clustered Oracle deployment, like Oracle Real Application Clusters
  FROM GV$SESSION
  WHERE
    USERNAME='LOOKER';

CREATE OR REPLACE SYNONYM LOOKER.LOOKER_SESSION FOR LOOKER_SESSION;

GRANT SELECT ON LOOKER.LOOKER_SESSION TO LOOKER;

Configurer des agrégations symétriques

Votre administrateur de base de données Oracle doit configurer la fonction LOOKER_HASH pour activer les agrégations symétriques. La fonction LOOKER_HASH est un synonyme de la fonction Oracle dbms_crypto.hash. L'administrateur de base de données doit également créer le synonyme et les droits associés. Les commandes suivantes supposent que le nom de l'utilisateur Looker est LOOKER :

Remarque : L'erreur ORA-00904: "LOOKER_HASH": invalid identifier indique que la fonction LOOKER_HASH, requise pour les agrégations symétriques, n'existe pas dans votre base de données. Cela peut se produire si vous avez ignoré la configuration des agrégats symétriques, qui aurait créé cette fonction.

CREATE OR REPLACE FUNCTION LOOKER_HASH(bytes raw, prec number)
  RETURN raw AS
  BEGIN
    return(dbms_crypto.HASH(bytes, prec));
  END;

CREATE OR REPLACE SYNONYM LOOKER.LOOKER_HASH FOR LOOKER_HASH;

GRANT EXECUTE ON LOOKER.LOOKER_HASH TO LOOKER;

GRANT EXECUTE ON SYS.LOOKER_HASH TO LOOKER;

Remarque : Selon la configuration de votre base de données Oracle, le préfixe SYS peut être SYSDBA, ADMIN ou inutile.

Configurer des tables dérivées persistantes

Pour activer les tables dérivées persistantes, accordez à l'utilisateur Looker les autorisations UNLIMITED TABLESPACE et CREATE TABLE. Les commandes suivantes supposent que le nom de l'utilisateur Looker est LOOKER :

GRANT UNLIMITED TABLESPACE TO LOOKER;
GRANT CREATE TABLE TO LOOKER;

Configurer l'arrêt des requêtes

Suivez ces instructions pour configurer l'arrêt des requêtes pour un déploiement Oracle standard ou un déploiement Amazon RDS.

Remarque : Lors d'un test de connexion, si l'erreur Test kill failed - Cannot cancel queries: undefined method '[]' for nil:NilClass s'affiche, elle peut être liée à des autorisations mal configurées pour l'arrêt des requêtes. L'erreur peut indiquer que les autorisations nécessaires ne sont pas appliquées correctement à l'utilisateur de la base de données spécifié dans les paramètres de connexion Looker, ou qu'elles ne sont pas appliquées du tout.

Déploiements Oracle standards

Pour configurer l'arrêt des requêtes dans les déploiements Oracle standards, l'administrateur de base de données Oracle doit créer la procédure LOOKER_KILL_QUERY en tant que synonyme de ALTER SYSTEM KILL SESSION. Pour ce faire, exécutez la commande suivante :

CREATE OR REPLACE PROCEDURE LOOKER_KILL_QUERY(p_sid in varchar2,
                                              p_serial# in varchar2)
IS
  cursor_name pls_integer default dbms_sql.open_cursor;
  ignore pls_integer;

BEGIN
  SELECT
    COUNT(*) INTO ignore
  -- If using a single node Oracle deployment
  FROM V$SESSION
  -- If using a clustered Oracle deployment, like Oracle Real Application Clusters
  FROM GV$SESSION
  WHERE
    username = USER
    AND sid = p_sid
    -- If using a single node Oracle deployment
    AND serial# = p_serial#;
    -- If using a clustered Oracle deployment, like Oracle Real Application Clusters
    AND (SERIAL# || ',' || INST_ID) = p_serial#;

  IF (ignore = 1)
  THEN
    dbms_sql.parse(cursor_name,
                   'ALTER SYSTEM KILL SESSION '''
                   || p_sid || ',' || p_serial# || '''',
                   dbms_sql.native);
    ignore := dbms_sql.execute(cursor_name);
  ELSE
    raise_application_error(-20001,
                            'You do not own session ''' ||
                            p_sid || ',' || p_serial# ||
                            '''');
  END IF;
END;

L'administrateur de base de données devra également exécuter les commandes associées suivantes :

CREATE OR REPLACE SYNONYM LOOKER.LOOKER_KILL_QUERY FOR SYS.LOOKER_KILL_QUERY;
GRANT EXECUTE ON SYS.LOOKER_KILL_QUERY TO LOOKER;

Remarque : Selon la configuration de votre base de données Oracle, le préfixe SYS peut être SYSDBA, ADMIN ou inutile.

Déploiements Amazon RDS

Dans les déploiements Amazon RDS Oracle, la procédure rdsadmin.rdsadmin_util.kill est utilisée pour arrêter les requêtes. Pour utiliser cette procédure, l'utilisateur de la base de données Looker doit disposer du rôle DBA.

Remarque : Comme le rôle DBA est un rôle de base de données élevé, vous pouvez envisager d'ignorer cette étape et de ne pas arrêter les requêtes dans Looker.

Pour donner à l'utilisateur de la base de données Looker la possibilité d'arrêter des requêtes, exécutez la commande suivante :

GRANT DBA TO LOOKER;

Créer la connexion entre Looker et votre base de données

Dans la section Admin de Looker, sélectionnez Connexions, puis cliquez sur Ajouter une connexion.

Saisissez les informations de connexion. La majorité des paramètres sont communs à la plupart des dialectes de base de données. Pour en savoir plus, consultez la page de documentation Connecter Looker à votre base de données. Les paramètres suivants sont spécifiques à Oracle :

• Nom : spécifiez le nom de la connexion. C'est sous ce nom que la connexion sera désignée dans les projets LookML.
• Dialecte : Oracle.
• Utiliser le TNS : activez les connexions TNS (Transparent Network Substrate).
• Hôte : nom d'hôte ou alias TNS.
• Port : port de la base de données.
• Base de données : nom de la base de données (si vous n'utilisez pas TNS).
• Nom du service : nom du service (si vous utilisez TNS).
• Nom d'utilisateur : nom d'utilisateur de la base de données ou base de données temporaire si les tables dérivées persistantes sont activées.
• Mot de passe : mot de passe de l'utilisateur de la base de données.
• Activer les PDT : utilisez ce bouton pour activer les tables dérivées persistantes. Lorsque les PDT sont activées, la fenêtre Connexion affiche des paramètres de PDT supplémentaires et la section Remplacements pour les PDT.
• Base de données temporaire : dans Oracle, un utilisateur est un schéma. Vous devez donc spécifier le nom de l'utilisateur de la base de données. Pour cet exemple, vous devez utiliser la valeur de schéma temporaire LOOKER.
• Nombre maximal de connexions du générateur de PDT : spécifiez le nombre de créations de PDT simultanées possibles sur cette connexion. Si vous définissez une valeur trop élevée, cela peut avoir un impact négatif sur les temps de requête. Pour en savoir plus, consultez la page de documentation Connecter Looker à votre base de données.
• Paramètres JDBC supplémentaires : laissez ce champ vide, car Oracle n'accepte pas de paramètres JDBC supplémentaires.
• Calendrier de maintenance : expression cron qui indique quand Looker doit vérifier les groupes de données et les tables dérivées persistantes. Pour en savoir plus sur ce paramètre, consultez la documentation sur la planification de la maintenance.
• SSL : cochez cette case pour utiliser des connexions SSL.
• Vérifier SSL : ignorez ce champ. Oracle utilisera le truststore Java par défaut pour vérifier le protocole SSL.
• Nombre maximal de connexions par nœud : vous pouvez conserver la valeur par défaut indiquée. Pour en savoir plus sur ce paramètre, consultez la section Nombre maximal de connexions par nœud de la page de documentation Connecter Looker à votre base de données.
• Délai avant expiration du pool de connexions : vous pouvez conserver la valeur par défaut indiquée. Pour en savoir plus sur ce paramètre, consultez la section Délai avant expiration du pool de connexions de la page de documentation Connecter Looker à votre base de données.
• Effectuer une mise en cache préalable de l'exécuteur SQL : pour que l'exécuteur SQL ne précharge pas les informations d'une table et les charge uniquement lorsque la table est sélectionnée, désélectionnez cette option. Pour en savoir plus sur ce paramètre, consultez la section Précache de l'exécuteur SQL de la page de documentation Connecter Looker à votre base de données.
• Fuseau horaire de la base de données : spécifiez le fuseau horaire utilisé dans la base de données. Laissez ce champ vide si vous ne souhaitez pas convertir le fuseau horaire. Pour en savoir plus, consultez la page de documentation Utiliser les paramètres de fuseau horaire.

Pour vérifier que la connexion est établie, cliquez sur le bouton Tester la connexion dans la section Détails de l'état en bas de la page Paramètres de connexion.

Si Looker affiche Connexion possible, appuyez sur Connecter pour créer la connexion.

Votre connexion de base de données est ensuite ajoutée à la liste de la page Connexions de la section Admin de Looker.

Prise en charge de fonctionnalités

Pour que Looker prenne en charge certaines fonctionnalités, votre dialecte de base de données doit également les prendre en charge.

Oracle est compatible avec les fonctionnalités suivantes à partir de Looker 26.22 :

Fonctionnalité	Compatibilité
Looker (Google Cloud Core)
Agrégations symétriques
Tables dérivées
Tables dérivées SQL persistantes
Tables dérivées natives persistantes
Vues stables
Arrêt des requêtes
Pivots basés sur SQL
Fuseaux horaires
SSL
Sous-totaux
Paramètres JDBC supplémentaires
Sensible à la casse
Type de lieu
Type de liste
Centile
Centile distinct
Afficher les processus dans l'exécuteur SQL
Décrire la table dans l'exécuteur SQL
Afficher les index dans l'exécuteur SQL
Sélectionner 10 dans l'exécuteur SQL
Nombre d'exécuteurs SQL
SQL Explain
Identifiants OAuth 2.0
Commentaires sur le contexte
Regroupement de connexions
Résumés HLL
Reconnaissance d'agrégats
Augmentation de tables PDT
Millisecondes
Microsecondes
Vues matérialisées
Mesures de variation par période
Nombre approximatif d'éléments distincts
Modèles d'analyse dans la base de données
Agendas personnalisés