连接到计算

连接

您可以将 AI 数据平台工作台与 Oracle Analytics Cloud 或其他商务智能工具连接起来。

您可以使用 AI Data Platform Workbench 提供的定制 JDBC 或 ODBC，从不同的商务智能工具连接到 Oracle AI Data Platform Workbench。AI Data Platform Workbench 还支持来自第三方商业 BI 工具（Tableau、Power BI）或开源 BI 工具（如 DBeaver）的连接。要从这些工具进行连接，需要在 AI 数据平台工作台中找到计算集群的连接详细信息，您可以在“连接详细信息”选项卡中找到这些详细信息。所需的信息因所连接的产品而异。

将 Oracle Analytics 连接到 Oracle AI Data Platform Workbench

您可以从 Oracle Analytics Cloud 实例连接到由 AI Data Platform 工作台实例管理的目录或表。

要创建从 Oracle Analytics 到 AI Data Platform Workbench 的连接，您需要来自 AI Data Platform 的连接文件和来自 Oracle Analytics Cloud 的 API 密钥。

获取 Oracle Analytics 连接配置文件

您需要从 Oracle AI Data Platform Workbench 实例下载 config.json 文件，以将其连接到 Oracle Analytics 。

您需要具有至少 2 个 OCPU、32 GB 内存（适用于驱动程序节点和 worker 节点）以及至少 2 个 worker 的计算集群。

导航到工作区，然后单击计算。
单击要连接到 Oracle Analytics 的集群。
在连接详细信息选项卡中，单击 Oracle Analytics Cloud 徽标下面的下载图标。config.json 文件将下载到您的计算机。

连接到 Oracle Analytics

您可以从 Oracle Analytics 实例连接到由 AI Data Platform 工作台实例管理的目录或表。

在 Oracle Analytics 中创建连接之前，请确保您具有来自 AI Data Platform 的连接配置文件。请参阅获取 Oracle Analytics 连接配置文件。

Oracle Analytics 与 AI Data Platform Workbench 实例的连接仅支持每个连接一个目录。您需要创建其他连接才能使用多个目录。

在 Oracle Analytics 主页上，依次单击创建和连接。
单击 Oracle AI Data Platform 。
为连接输入名称和说明。
在位置中，指定保存连接的位置。要与其他用户共享连接，请将其保存在 /Shared Folders 中。
在 Oracle Analytics Cloud 中，对于连接详细信息，单击选择，导航到 config.json 文件，然后单击打开。
选择 API 密钥作为验证类型。
在公共 API 密钥下，依次单击生成和复制。
在 OCI 中，添加 API 密钥。
1. 在 OCI 中，单击用户图标，然后单击用户设置。
2. 在“我的概要信息”中，单击令牌和密钥，然后单击添加 API 密钥。
3. 选择粘贴公共密钥，然后在步骤 7 中生成的密钥中复制，然后单击添加。
等待两到三分钟，API 密钥才能同步。
在目录中，指定要在数据集中使用的目录名称。
如果目录列表未加载，并且您看到预警消息“用户没有足够的权限执行该操作”，请等待 API 密钥稍候以进行同步。
单击保存。
通过创建数据集测试新连接。

如果您已按照说明操作，并且仍然在保存连接或列出方案时出现问题，则可能需要重新启动群集。

下载 JDBC 驱动程序

您可以从“Connection details（连接详细信息）”选项卡下载 JDBC 驱动程序并为不同的 BI 工具进行配置。

导航到工作区，然后单击计算。
单击要连接到 JDBC 兼容 BI 工具的集群，然后单击连接。
单击下载 JDBC 驱动器。

配置 DBeaver

您需要安装 DBeaver 并准备从 Oracle AI Data Platform Workbench 下载的文件，然后才能将其连接到 AI Data Platform 工作台中的计算集群。

下载并安装 DBeaver 客户机。您可以使用 Community 版本或 Enterprise 版本，但它们必须至少 22.x.DBeaver 只能用于 Windows、Mac OS X、Eclipse 插件和 Linux。
从下载 JDBC 驱动程序中解压缩文件。
从解压缩的文件中解压缩 simbaSpark.zip 驱动程序文件。

使用 Spark Simba JDBC 驱动程序配置 DBeaver

您可以将 DBeaver 配置为连接到 Oracle AI Data Platform Workbench 中的计算集群。

您必须已安装 DBeaver 并提取从 AI 数据平台工作台下载的 simbaSpark.zip 文件。

打开 DBeaver。
单击数据库导航器。
单击驱动程序管理器。
单击新建。
输入 AI 数据平台作为驱动程序名称。
单击库。
单击添加文件夹。
浏览到 sparkSimba.zip 提取的位置。
单击查找类。
选择确定。
将 Driver class 设置为 com.simba.spark.jdbc.Driver 。
单击设置。
将 Class Name 设置为 com.simba.spark.jdbc.Driver 。
单击确定。

在 DBeaver 中创建数据库连接

要将 DBeaver 连接到 Oracle AI Data Platform Workbench 中的计算集群，您需要首先在 DBeaver 中创建数据库连接。

您必须已使用从 AI Data Platform Workbench 下载的 Spark Simba JDBC 驱动程序配置 DBeaver。有关详细信息，请参阅使用 Spark Simba JDBC 驱动程序配置 DBeaver 。

打开 DBeaver。
单击数据库中。
单击新建数据库连接。
单击全部。
选择 AI Data Platform 。
单击下一步。
输入 JDBC 驱动器的 URL。您可以在 AI Data Platform Workbench 的计算集群的连接详细信息选项卡上找到 JDBC URL。
单击完成。

使用 JDBC 将 DBeaver 连接到 Oracle AI Data Platform Workbench

配置 DBeaver 并与 AI 数据平台工作台建立数据库连接后，您可以在 DBeaver 和 AI 数据平台工作台之间完成连接。

打开 DBeaver。
单击连接。
选择使用授权令牌或 API 密钥进行连接。
- 使用授权令牌进行连接
  - 如果您没有 DEFAULT 配置文件，请通过在 URL 中不指定任何配置文件来使用标记。例如：jdbc:spark://gateway.aidp.me-riyadh-1.oci.oraclecloud.com/default;SparkServerType=AIDP;httpPath=cliservice/cf18b4ef-b83e-41dd-82b6-8d391584f6c5
    URL 将打开浏览器窗口。
    
    登录到创建 AI 数据平台工作台实例的租户。
    
    有关更多信息，请参见 Token-based Authentication for the CLI 。
- 使用 API 密钥进行连接，方法是在连接 URL 中通过 ociProfile=<profile_name> 指定 OCI 配置文件。
  - 使用 API 密钥验证连接到 AI Data Platform Workbench 实例。
    通过在连接 URL 中使用 ociProfile=<profile_name> 指定 OCI 配置文件来使用 API 密钥。例如，要使用 OCI Profile name Demo，请执行以下操作：jdbc:spark://gateway.aidp.me-riyadh-1.oci.oraclecloud.com/default;SparkServerType=AIDP;httpPath=cliservice/cf18b4ef-b83e-41dd-82b6-8d391584f6c5 ;ociProfile=Demo
    
    有关更多信息，请参见 Required Keys and OCIDs 。
DBeaver 创建用于读取元数据的连接，以及用于所有其他操作的连接。如果您对连接受限，则可以禁用第二个连接，以便 DBeaver 对所有操作使用一个连接。
1. 单击首选项。
2. 单击公用。
3. 单击元数据。
4. 取消选择为元数据读取打开单独的连接。

下载 ODBC 驱动程序

您可以从“连接详细信息”选项卡下载 ODBC 驱动程序，并为不同的 BI 工具进行配置。

导航到工作区，然后单击计算。
单击要连接到 ODBC 兼容 BI 工具的集群，然后单击连接。
单击 Download ODBC Driver（下载 ODBC 司机）。
从列表中选择相应的 OS。

10 连接到计算

连接