Oracle AI Data Platform Workbench 入门

AI 功能的要求

为了在 Oracle AI Data Platform Workbench 中使用 AI 功能，您需要预配 Oracle Autonomous AI Lakehouse 实例。

在创建 Oracle AI Data Platform Workbench 实例的过程中，必须创建和配置 Oracle Autonomous AI Lakehouse 。您可以选择在创建第一个 AI Data Platform Workbench 实例时创建 Autonomous AI Lakehouse 实例，也可以选择使用现有的 Autonomous AI Lakehouse 实例。如果您使用的是现有的 Autonomous AI Lakehouse ，则还必须为该实例的 ADMIN 用户提供密码。

注意：

现有的 Autonomous AI Lakehouse 实例必须至少为 26ai 或更高版本。在创建 AI Data Platform Workbench 实例过程中创建新的 Autonomous AI Lakehouse 实例时，它会自动配置为 26ai 或更高版本。

Autonomous AI Lakehouse 实例用作 AI Data Platform Workbench 中 AI 工作负载的基础数据层，并用作所有 AI 本机功能的默认向量存储。Autonomous AI Lakehouse 实例需要 Oracle Autonomous AI Lakehouse 版本 26ai 或更高版本，并且必须在 AI Data Platform Workbench 中启用 AI 功能，包括：

知识库 (KB)，
代理流，
AI Compute。

如果没有 Autonomous AI Lakehouse 实例，AI Data Platform Workbench 将继续支持结构化数据摄取和转换，但 AI 原生功能仍然处于禁用状态。

注意：

如果您的租户已达到一个或多个 Autonomous AI Lakehouse 限额，则无法在创建 AI Data Platform Workbench 实例时创建新的 Autonomous AI Lakehouse 实例。在这种情况下，您必须选择现有的 Autonomous AI Lakehouse 实例，或者与技术支持团队联系以请求提高配额。

您必须为 AI 功能启用以下 IAM 策略：

允许 Oracle AI Data Platform Workbench 服务调用 OCI GenAI 服务中托管的 LLM：

allow any-user to use generative-ai-family in tenancy where all { request.principal.type='aidataplatform'}

注意：

根据 AI 数据平台工作台的创建时间，您的主体类型可能是 'datalake'，而不是 'aidataplatform'。您可以通过查看 AI 数据平台工作台 OCID 的详细信息来检查主用户类型。

允许 Oracle AI Data Platform Workbench 服务供应和管理 Oracle Autonomous AI Lakehouse 资源以启用 AI 功能：

allow group <aidpAdminGroup> to manage autonomous-databases in <aidp compartment>

存储加密选项

您可以使用 Oracle 管理的加密密钥，也可以在组织需要直接控制密钥生命周期和轮换时从 OCI Vault 选择您自己的客户管理的密钥 (CMK)。

Oracle AI Data Platform Workbench 默认对静态数据进行加密。在配置第一个 AI Data Platform Workbench 实例时，您可以选择保留默认的 Oracle 管理的加密密钥，或者当您的组织需要直接控制密钥生命周期和轮换时，您可以从 OCI Vault 选择自己的 CMK。如果您希望进行最简单的设置并且不需要自己管理密钥材料，可以使用 Oracle 管理的密钥。当安全策略要求您控制加密密钥的 Vault、密钥轮换过程、访问边界或审计线索时，请使用客户管理的密钥。

客户管理的密钥先决条件（预览）

在选择客户管理的密钥之前，请确保满足以下先决条件：

您有权查看目标区间中的 OCI Vault 和密钥。有关在 OCI 中配置 Vault 和密钥的更多信息，请参阅配置 IAM 策略。
您的 OCI Vault 与 AI Data Platform Workbench 部署位于同一区域中。
您在该 Vault 中有一个主加密密钥。
密钥已启用且可供使用。
必须选择长度为 256 位的 AES 对称主密钥。

默认行为 -Oracle 托管密钥

如果您未选择客户管理的密钥，Oracle AI Data Platform Workbench 将自动使用 Oracle 管理的密钥。这是默认选项，不需要其他 Vault 配置。在以下情况下选择此选项：

您需要最快的预配路径。
您的团队不需要直接管理或轮换加密密钥。
您的安全策略允许对静态服务数据使用 Oracle 管理的加密。

选择客户管理的密钥之前的注意事项

客户管理的密钥可提供更多控制，但同时也增加了运营责任。

如果 Vault 或密钥变得不可用，则依赖于加密的操作可能会失败。
如果禁用、删除或计划删除密钥，则可能会影响对受保护数据的访问。
密钥轮换、区间设计和 IAM 策略将成为运营运行手册的一部分。
预配或更新流可能需要比 Oracle 管理的默认路径长的时间。

疑难解答

如果您在设置 AI Data Platform Workbench 实例时未看到客户管理的密钥选项，请检查以下内容：

确认您的租户中已启用该功能。
确认您具有读取 Vault 和密钥的权限。
确认 Vault 和密钥与工作台位于同一区域中。

限制

创建工作台实例后，无法更改加密密钥。要更改加密策略，您必须创建新的工作台实例并将代码移动到该实例。

创建第一个 AI 数据平台工作台

在创建第一个 Oracle AI Data Platform Workbench 之前，您需要确保您具有正确的 IAM 权限。

LiveLabs Sprint

在创建或使用 AI 数据平台工作台之前，请检查以下内容：

您对要在其中创建 AI 数据平台工作台的区间具有相应权限。有关更多信息，请参见 Managing Compartments 。
如果您已经为区间设置了标记默认值，则在该范围内创建 AI 数据平台工作台实例时可能会遇到问题。有关更多信息，请参见 Known Issues 。

在 OCI 的“主页”部分中，单击分析和 AI 。
单击 AI Data Platform Workbenches 。
单击创建 AI 数据平台工作台。Oracle AI Data Platform Workbench 将执行检查以验证所有必需的 IAM 策略是否都到位。
为 AI 数据平台工作台实例提供名称和说明。
为第一个 AI 数据平台工作台工作区提供名称和说明。
AI 功能需要 Oracle Autonomous AI Lakehouse 实例。选择是创建新实例还是使用现有的实例。
- 对于新建，为实例的 ADMIN 用户提供新密码。
- 对于选择现有，选择区间和实例，然后输入现有实例的 ADMIN 用户的密码。您的现有实例必须为 26ai 或更高版本。
选择加密密钥是 Oracle 管理的（默认设置）还是客户管理的。
- Oracle 管理的密钥是默认选项，不需要其他 Vault 配置。
- 客户管理的密钥是选择组织是否需要直接控制密钥生命周期和轮换的选项。您需要为加密密钥提供 Vault OCID 和 Key OCID 。单击验证以确认提供的 OCID 有效。
从添加策略中选择以下选项之一：
- 标准（建议）：在租户级别广泛应用访问设置。
- 高级：允许您在区间级别配置细粒度访问。
检查缺少的策略（如果有），并根据需要应用这些策略。
展开可选策略。查看并添加您的实例所需的任何其他策略。有关详细信息，请参阅 Oracle AI Data Platform Workbench 的 IAM 策略。
单击高级选项为 AI 数据平台工作台提供元数据标记。单击添加标记以添加多个标记。
单击创建 AI 数据平台工作台。

访问 Oracle AI Data Platform Workbench

您可以访问您或您所属的角色已为其提供权限的任何 Oracle AI Data Platform Workbench。

您至少需要 AI Data Platform Workbench IAM 策略中的 USE 权限才能访问 AI Data Platform Workbench。有关详细信息，请参阅 Oracle AI Data Platform Workbench 的 IAM 策略。

在 OCI 的“主页”部分中，单击分析和 AI 。
单击 AI Data Platform Workbench ，然后单击 AI Data Platform Workbenches 。
单击要访问的 AI 数据平台工作台。

从 URL 访问 Oracle AI Data Platform Workbench

您可以直接从 URL 访问 Oracle AI Data Platform Workbench 实例。

Oracle AI Data Platform Workbench 的 URL 使用以下格式，其中 tenant_name 是用于登录的 OCI 账户的名称，domain_name 是您选择的域：

https://<hash>.datalake.oci.oraclecloud.com/#?&tenant=<<tenant_name>>&domain=<<domain_name>>

您还可以通过在主页上右键单击 AI 数据平台工作台实例名称并单击复制链接来获取指向实例的直接链接。

您可以与其他用户共享 AI 数据平台工作台实例 URL。这些用户需要具有适当的权限才能访问实例。有关更多信息，请参阅关于权限。

了解工作区和 UI 流

创建或访问 AI 数据平台工作台后，用户界面可帮助您无缝地在工作台内导航和管理所有关键组件。

左侧导航概览

在 AI Data Platform Workbench 中，左侧边栏包含：

主页 - 将您带回仪表盘
主目录 - 查看跨工作区的所有已注册数据资产
工作区 - 直接访问工作区详细信息
选择工作区 - 用于在不同工作区之间切换的下拉列表
- 在工作区中，您将看到：
  - 工作流 - 设计和调度数据工作流
  - 计算—管理 Spark 计算环境
数据共享 - 与支持 Delta 共享协议的其他服务共享数据
自动填充目录 - 自动从连接的源摄取元数据
通知 - 搜索和筛选您收到的系统消息
角色 - 配置访问控制 (RBAC)
审计日志 - 在 AI 数据平台工作台中搜索和筛选对象的历史记录

设置后的后续步骤

创建 Oracle AI Data Platform Workbench 后，您可以对其进行定期准备。

当您创建了 Oracle AI Data Platform Workbench 并首次访问它时，以下是确保其可供使用的后续步骤：

查看 IAM 策略和角色 - 确保通过“角色”选项卡为用户和组设置了正确的访问权限。有关更多信息，请参见 Roles 。
设置计算—在“计算”选项卡中配置 Spark 计算，以高效地运行工作流。有关更多信息，请参见 Compute 。
摄取和组织数据 - 首先创建目录来组织数据源。有关详细信息，请参阅数据管理。
浏览记事本 - 使用记事本执行即席探索、转换或机器学习任务。有关更多信息，请参见记事本。

编辑 AI 数据平台工作台

您可以编辑您拥有的 Oracle AI Data Platform Workbench 的详细信息。

在 OCI 的“主页”部分中，单击分析和 AI 。
单击 AI Data Platform Workbench ，然后单击 AI Data Platform Workbenches 。
单击 AI 数据平台工作台旁边的操作，然后单击编辑。
修改详细信息，然后单击保存。

删除 AI 数据平台工作台

您可以删除您拥有的未使用或冗余 AI Data Platform Workbenches。

在 OCI 的“主页”部分中，单击分析和 AI 。
单击 AI Data Platform Workbench ，然后单击 AI Data Platform Workbenches 。
单击 AI 数据平台工作台旁边的操作，然后单击删除。
选择是否删除：
- 主目录中的所有托管数据
- 所有工作区中的所有文件和文件夹
在出现提示时输入删除。单击删除。

会话管理

Oracle AI Data Platform Workbench 实施会话管理控制，确保安全可靠的用户体验。

AI Data Platform Workbench 的会话生命周期为 8 小时。用户会话在此会话生命周期结束后自动过期。此行为符合 Oracle Cloud Infrastructure (OCI) 安全标准，可确保会话令牌无限期无效，从而降低未经授权访问的风险。

8 小时后，用户必须重新进行身份验证才能继续在工作台中工作。

这些控件旨在平衡可用性与整个平台的强大安全性和治理实践。

2 Oracle AI Data Platform Workbench 入门