您正在查看 Looker 26.2 的文档。点击此链接可查看最新文档。

Google 会使用 AI 技术将内容翻译成您偏好的语言。AI 翻译可能包含错误。

Oracle Autonomous Data Warehouse on Cloud

Looker 对 Oracle ADWC 提供集成级支持。本页面介绍了如何将 Looker 连接到 Oracle ADWC。

加密网络流量

对 Looker 应用与数据库之间的网络流量进行加密是一种最佳实践。可以考虑启用安全的数据库访问文档页面上介绍的某个选项。

为连接设置 Looker 主机

所有 Oracle ADWC 连接都需要 SSL 和证书身份验证。为了让 Looker 连接到您的 Oracle ADWC 实例，您需要下载 Oracle 钱包文件并将其安装在 Looker 服务器上。如果您是客户托管的 Looker 用户，则需要拥有 Looker 服务器访问权限的系统管理员来执行此操作。如果您是 Looker 托管的用户，请与 Looker 支持团队联系。

如需在 Looker 服务器上安装 Oracle 钱包，请执行以下操作：

将 Oracle 钱包下载到您的本地计算机。您将获得一个 zip 文件，其名称类似于 Wallet_databasename.zip。
在 Looker 服务器上，创建一个目录来存放钱包 zip 文件：
```
mkdir /home/looker/looker/credentials
```
将钱包 zip 文件从本地计算机复制到 Looker 服务器。此示例使用 scp 并将文件放置在 /home/looker/looker/credentials 中：
```
scp Wallet_databasename.zip username@remotehost:/home/looker/looker/credentials
```

解压缩钱包 zip 文件。此示例使用命令 unzip：

cd /home/looker/looker/credentials
unzip Wallet_databasename.zip

使用 ls 命令验证钱包的内容。您应该拥有以下文件：
```
 ls

 cwallet.sso  keystore.jks      sqlnet.ora    truststore.jks
 ewallet.p12  ojdbc.properties  tnsnames.ora
```
Looker 使用 Oracle 钱包通过 JDBC Thin Driver 18.3 连接到 Oracle ADWC。为此，您需要数据库的 Oracle ADWC 服务等级的透明网络底层 (TNS) 别名以及 Oracle 钱包文件的路径。
如需获取数据库的 TNS 别名，请运行以下命令：
```
cat tnsnames.ora
```
您可以从三个 TNS 别名中进行选择：dbname_high、dbname_medium 和 dbname_low。这些别名对应于不同的服务等级。此文件包含协议、主机、端口、服务名称和 SSL 信息。在此示例中，我们将使用 dbname_medium。

创建 Looker 用户

首先，创建一个指定的 Looker 用户：

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

接下来，让新的 Looker 用户能够创建会话：

  GRANT CREATE SESSION TO LOOKER;

最后，为 Looker 用户授予您计划从 Looker 访问的数据表的相应 SELECT 权限。如果您日后想要访问其他表，还需要为这些新表授予 SELECT 权限。

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

确保 Looker 可以查看所有表

Looker 可能无法识别表（尤其是空表），除非先在 Oracle 中收集统计信息。如果您需要的表未显示在生成的 LookML 或 SQL Runner 中，请执行以下命令：

  EXEC DBMS_STATS.GATHER_DATABASE_STATS;

如需了解其他方法，请参阅 Oracle 文档。

设置主要数据库对象

您的 Oracle DBA 必须在 Oracle 上设置以下对象和权限。以下命令会将 LOOKER_SESSION 和 LOOKER_SQL 创建为 V$SESSION 和 V$SQL 的同义词。

以根用户身份运行以下命令以完成此设置。这些示例假定 Looker 用户的名称为 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=&apos;LOOKER&apos;;

CREATE OR REPLACE SYNONYM LOOKER.LOOKER_SQL FOR LOOKER_SQL;

GRANT SELECT ON LOOKER.LOOKER_SQL TO LOOKER;

-- Pay special attention to the 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 ADWC deployment
    "SERIAL#",
    -- If using a clustered Oracle ADWC deployment
    (SERIAL# || ',' || INST_ID) AS "SERIAL#",
    AUDSID
  -- If using a single node Oracle ADWC deployment
  FROM V$SESSION
  -- If using a clustered Oracle ADWC deployment
  FROM GV$SESSION
  WHERE
    USERNAME=&apos;LOOKER&apos;;

CREATE OR REPLACE SYNONYM LOOKER.LOOKER_SESSION FOR LOOKER_SESSION;

GRANT SELECT ON LOOKER.LOOKER_SESSION TO LOOKER;

设置对称聚合

您的 Oracle DBA 必须设置 LOOKER_HASH 函数才能启用对称聚合。LOOKER_HASH 函数是 Oracle dbms_crypto.hash 函数的同义词。DBA 还必须创建关联的同义词和权限。以下示例假定 Looker 用户的名称为 LOOKER：

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;

根据您的 Oracle 数据库配置，SYS 前缀可能是 SYSDBA、ADMIN，也可能是不必要的。

设置永久性派生表

如需启用永久性派生表，请为 Looker 用户授予 UNLIMITED TABLESPACE 和 CREATE TABLE 权限。以下命令假定 Looker 用户的名称为 LOOKER：

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

设置查询终止

如需设置查询终止，Oracle DBA 必须创建 LOOKER_KILL_QUERY 过程作为 ALTER SYSTEM KILL SESSION 的同义词。为此，请执行以下命令：

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 ADWC deployment
  FROM V$SESSION
  -- If using a clustered Oracle ADWC deployment
  FROM GV$SESSION
  WHERE
    username = USER
    AND sid = p_sid
    -- If using a single node Oracle ADWC deployment
    AND serial# = p_serial#;
    -- If using a clustered Oracle ADWC deployment
    AND (SERIAL# || ',' || INST_ID) = p_serial#;

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

DBA 还需运行以下相关命令：

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

根据您的 Oracle 数据库配置，SYS 前缀可能是 SYSDBA、ADMIN，也可能是不必要的。

创建 Looker 与数据库的连接

请按照以下步骤创建从 Looker 到数据库的连接：

在 Looker 的管理部分中，选择连接，然后点击添加连接 。
填写连接详情。这些设置中的大多数设置对于大多数数据库方言都是通用的。如需了解相关信息，请参阅将 Looker 连接到数据库文档页面。以下设置特定于 Oracle ADWC：
- 方言：Oracle ADWC。
注意：如果您使用的是 Looker (Google Cloud Core) 实例，并且在方言下拉菜单中没有看到您的方言，请参阅 Looker (Google Cloud Core) 文档，验证 Looker (Google Cloud Core) 实例是否支持该方言。
- 使用 TNS：启用透明网络底层 (TNS) 连接。
- 主机：主机名或 TNS 别名。在此示例中，为 dbname_medium。
- 端口：保留默认值；Looker 将从 tnsnames.ora 文件中查找端口。
- 服务名称：留空；Looker 将从 tnsnames.ora 文件中查找服务名称。
- 用户名：数据库用户名或 Temp Database（如果已启用 PDT）。
- 密码：数据库用户密码。
- 启用 PDT：使用此开关启用永久性派生表。启用 PDT 后，连接窗口会显示其他 PDT 设置和 PDT 替换项 部分。
- 临时数据库：在 Oracle 中，用户是架构，因此应将其指定为数据库用户的名称。在此示例中，您将使用临时架构值 LOOKER。
- 其他 JDBC 参数：Looker 服务器上 Oracle 钱包的 PATH 。在此示例中，它是 /home/looker/looker/credentials。
- 在 Looker 托管的旧版部署中，此值为 /home/lookerops/looker/credentials。
- 在下一代托管中的 Looker 托管部署中，此值为 /app/credentials。
- SSL 和验证 SSL：您可以忽略这些字段；Looker 将始终对 Oracle ADWC 使用 SSL。
如需验证连接是否成功，请点击测试。如需了解问题排查信息，请参阅测试数据库连接文档页面。点击测试后，Looker 将构建如下所示的 JDBC 字符串：

jdbc:oracle:thin:@dbname_medium?TNS_ADMIN=/home/looker/looker/credentials
如需保存这些设置，请点击连接。

功能支持

如需让 Looker 支持某些功能，您的数据库方言也必须支持这些功能。

截至 Looker 26.2，Oracle ADWC 支持以下功能：

功能	是否支持？
Looker (Google Cloud Core)
对称聚合
派生表
永久性 SQL 派生表
永久性原生派生表
稳定视图
查询终止
基于 SQL 的数据透视
时区
SSL
小计
其他 JDBC 参数
区分大小写
位置类型
名单类型
百分位
不同值百分位
SQL Runner “Show Processes”
SQL Runner “Describe Table”
SQL Runner “Show Indexes”
SQL Runner “Select 10”
SQL Runner “Count”
SQL “Explain”
OAuth 2.0 凭证
上下文注释
连接池
HLL 草图
汇总感知
递增 PDT
毫秒
微秒
具体化视图
与前一时间段相比的指标
近似计数不同