数据分析工具中的矢量搜索

Prerequisites

要使用数据分析工具中的向量搜索功能，您需要执行以下操作：

您必须拥有支持 Vector 的 26ai 数据库。
ORDS REST API 必须支持 VECTOR 数据类型。
必须使用“Data Studio 设置”页才能选择用于向量搜索的相同身份证明。
源数据必须先嵌入非数字列。
要在数据分析工具中使用矢量搜索，您必须具有：
- OpenAI、Cohere 或 Azure OpenAI 账户服务（含信用）
- 对 DBMS_VECTOR 和 DBMS_VECTOR_CHAIN.UTL_TO_EMBEDDING 软件包的访问。
注意：
- 必须设置 AI 配置文件。按照本章中提到的步骤使用 Select AI 从自然语言提示生成 SQL 。
- 创建并配置 AI 配置文件后，在 Data Studio 导航菜单上的 Data Studio 设置向导中设置 AI 配置文件，以使用 AI 功能，例如在 Data Studio 工具中从自然语言生成 SQL 和向量搜索。

数据分析工具利用 Vector Utility PL/SQL 程序包 DBMS_VECTOR 和 DBMS_VECTOR_CHAIN.UTL_TO_EMBEDDING 提供第三方 REST API，使您能够与外部嵌入模型（例如 Cohere、Google AI、Hugging Face、Oracle Cloud Infrastructure (OCI) Generative AI、OpenAI 或 Vertex AI）进行交互。您必须了解使用第三方嵌入模型的条款。

注意：

数据库的某些功能允许您访问第三方单独提供的服务，例如，通过使用 JSON 规范来方便您访问 REST API。

您须自行负责对您的会员注册名和密码保密，且须对您在会员注册名和密码下发生的所有活动承担责任。尽管有与第三方服务相关的任何其他条款和条件，贵方对此类数据库功能的使用构成贵方接受该风险，并明确排除 Oracle 对此类访问造成的任何损害的责任或责任。

假设你是一个金融爱好者，你想通过新闻了解金融，以获得更好的金融产品和投资意识。在此示例中，可以使用向量搜索功能查找与单词 Bank 相关的新闻。

假设一个表包含 CATEGORY、FILENAME、TITLE、CONTENT 列以及标记为 VECTOR 的不同列，该列包含 CONTENT 列的向量表示形式。由于我们可以对具有非数字数据（图像或文本）的源列使用向量搜索，因此任何非数字列都可以嵌入并存储为向量列。但在此示例中，我们需要从 CONTENT 列中搜索相关文本。

您可以使用“数据分析”工具执行向量搜索。

要指示在向量列中保留哪一列的嵌入，必须首先使用数据分析工具使用适当的向量映射相应的列，搜索类似的文本，然后运行查询。“查询结果”选项卡将显示类似于 Bank 的内容。

从“数据分析”工具中，单击“分析”下的 + 以创建新的“分析”。
从 Schema（方案）下拉列表中选择方案，从 Type（类型）下拉列表中选择查询。
选择要从表浏览器查询的表。在此示例中，您将选择 BBCNEWS_DATA_ENCODE。

插图 select-table.jpg 的说明
在 SQL 工作表编辑区域中输入 Select 语句，以从 BBCNEWS_DATA_ENCODE 表检索所有列。
指定以下命令：
```
Select * from BBCNEWS_DATA_ENCODE;
```
单击运行。

插图 run-data-analysis.jpg 的说明

您可以在“查询结果”选项卡中查看 BBCNEWS_DATA_ENCODE 表的所有列。
从显示各种显示查询结果可视化的模式的图标中选择模式的表格式视图。

插图 tabular-view.jpg 的说明
将 CONTENT 列拖放到“列”放置区域，然后单击该列以映射向量列。

插图 map-vector-column.jpg 的说明
在“映射向量列”向导中，指定以下字段值：
- 映射向量：从下拉列表中选择包含所选列的向量嵌入的列。在此示例中，它是 VECTOR 。
- 选择服务：选择将用于利用此工具功能的 AI 服务。在此示例中，它是 OCI Generative AI 。
- 选择身份证明：输入从 Data Studio 设置创建的身份证明以访问第三方服务提供商。您需要这些身份证明才能在对所选第三方服务提供商的 REST API 调用期间启用访问。
- 生成式 AI URL ：指定将用于调用第三方服务提供商的生成式 AI URL，例如 Cohere、Google AI、Hugging Face、Oracle Cloud Infrastructure (OCI) Generative AI、OpenAI 或 Vertex AI。
- 选择模型：指定将用于从文本生成嵌入的嵌入模型。在此示例中，您将输入 cohere.embed-english-light-v2.0 。
单击 Save（保存）保存映射。选择清除可清除在此步骤中提到的字段值。
在“分面筛选器”上，可以查看“内容”列下的文本框。单击 + 号以展开文本框。

插图 text.jpg 的说明
在文本框中输入与 CONTENT 列中的单词 Bank 相似的内容的以下文本：
```
BANK
```
单击搜索。

插图 bank.jpg 的说明
“输出”面板的“查询结果”选项卡显示包含与 Bank 相关的内容的内容列。

插图 results.jpg 的说明

您可以将鼠标悬停在每个内容上以查看其展开的表单。

插图 extended-content.jpg 的说明