跳至主要内容

Oracle AI 向量搜索：文档处理

Oracle AI 向量搜索专为人工智能 (AI) 工作负载而设计，允许您根据语义而不是关键字查询数据。Oracle AI 向量搜索的最大优势之一是，非结构化数据的语义搜索可以与一个系统中的业务数据的关联搜索相结合。这不仅功能强大，而且效率更高，因为您无需添加专门的向量数据库，从而消除了多个系统之间数据碎片化的痛苦。

此外，您的向量可以从 Oracle 数据库的所有强大功能中获益，例如：

本指南演示了如何在 Oracle AI 向量搜索中使用文档处理功能来分别使用 OracleDocLoader 和 OracleTextSplitter 加载和分块文档。

如果您刚开始使用 Oracle 数据库，请考虑探索 免费的 Oracle 23 AI，它提供了有关设置数据库环境的绝佳介绍。在使用数据库时，通常建议默认情况下不要使用系统用户；相反，您可以创建自己的用户以增强安全性并进行自定义。有关用户创建的详细步骤，请参考我们的 端到端指南，其中还介绍了如何在 Oracle 中设置用户。此外，了解用户权限对于有效管理数据库安全至关重要。您可以在官方 Oracle 指南 中了解有关管理用户帐户和安全的更多信息。

先决条件​

请安装 Oracle Python 客户端驱动程序以将 Langchain 与 Oracle AI 向量搜索一起使用。

# pip install oracledb

连接到 Oracle 数据库​

以下示例代码将显示如何连接到 Oracle 数据库。默认情况下，python-oracledb 在“精简”模式下运行，该模式直接连接到 Oracle 数据库。此模式不需要 Oracle 客户端库。但是，在 python-oracledb 使用这些库时，可以使用一些其他功能。当使用 Oracle 客户端库时，据说 python-oracledb 处于“完整”模式。两种模式都具有全面的功能，支持 Python 数据库 API v2.0 规范。请参阅以下 指南，该指南介绍了每种模式支持的功能。如果您无法使用精简模式，则可能需要切换到完整模式。

import sys

import oracledb

# please update with your username, password, hostname and service_name
username = "<username>"
password = "<password>"
dsn = "<hostname>/<service_name>"

try:
    conn = oracledb.connect(user=username, password=password, dsn=dsn)
    print("Connection successful!")
except Exception as e:
    print("Connection failed!")
    sys.exit(1)

现在让我们创建一个表并插入一些示例文档以进行测试。

try:
    cursor = conn.cursor()

    drop_table_sql = """drop table if exists demo_tab"""
    cursor.execute(drop_table_sql)

    create_table_sql = """create table demo_tab (id number, data clob)"""
    cursor.execute(create_table_sql)

    insert_row_sql = """insert into demo_tab values (:1, :2)"""
    rows_to_insert = [
        (
            1,
            "If the answer to any preceding questions is yes, then the database stops the search and allocates space from the specified tablespace; otherwise, space is allocated from the database default shared temporary tablespace.",
        ),
        (
            2,
            "A tablespace can be online (accessible) or offline (not accessible) whenever the database is open.\nA tablespace is usually online so that its data is available to users. The SYSTEM tablespace and temporary tablespaces cannot be taken offline.",
        ),
        (
            3,
            "The database stores LOBs differently from other data types. Creating a LOB column implicitly creates a LOB segment and a LOB index. The tablespace containing the LOB segment and LOB index, which are always stored together, may be different from the tablespace containing the table.\nSometimes the database can store small amounts of LOB data in the table itself rather than in a separate LOB segment.",
        ),
    ]
    cursor.executemany(insert_row_sql, rows_to_insert)

    conn.commit()

    print("Table created and populated.")
    cursor.close()
except Exception as e:
    print("Table creation failed.")
    cursor.close()
    conn.close()
    sys.exit(1)

加载文档​

用户可以通过适当配置加载程序参数，灵活地从 Oracle 数据库、文件系统或两者加载文档。有关这些参数的全面详细信息，请参阅 Oracle AI 向量搜索指南。

利用 OracleDocLoader 的一个重要优势是它能够处理超过 150 种不同的文件格式，无需为不同的文档类型使用多个加载程序。有关支持格式的完整列表，请参阅 Oracle 文本支持的文档格式。

以下是一个示例代码片段，演示了如何使用 OracleDocLoader

from langchain_community.document_loaders.oracleai import OracleDocLoader
from langchain_core.documents import Document

"""
# loading a local file
loader_params = {}
loader_params["file"] = "<file>"

# loading from a local directory
loader_params = {}
loader_params["dir"] = "<directory>"
"""

# loading from Oracle Database table
loader_params = {
    "owner": "<owner>",
    "tablename": "demo_tab",
    "colname": "data",
}

""" load the docs """
loader = OracleDocLoader(conn=conn, params=loader_params)
docs = loader.load()

""" verify """
print(f"Number of docs loaded: {len(docs)}")
# print(f"Document-0: {docs[0].page_content}") # content
API 参考：OracleDocLoader | Document

拆分文档​

文档的大小可能会有所不同，从很小到非常大。用户通常希望将其文档分成更小的部分，以方便生成嵌入。此拆分过程有许多自定义选项可用。有关这些参数的全面详细信息，请参阅 Oracle AI 向量搜索指南。

以下是一个示例代码，说明了如何实现这一点

from langchain_community.document_loaders.oracleai import OracleTextSplitter
from langchain_core.documents import Document

"""
# Some examples
# split by chars, max 500 chars
splitter_params = {"split": "chars", "max": 500, "normalize": "all"}

# split by words, max 100 words
splitter_params = {"split": "words", "max": 100, "normalize": "all"}

# split by sentence, max 20 sentences
splitter_params = {"split": "sentence", "max": 20, "normalize": "all"}
"""

# split by default parameters
splitter_params = {"normalize": "all"}

# get the splitter instance
splitter = OracleTextSplitter(conn=conn, params=splitter_params)

list_chunks = []
for doc in docs:
    chunks = splitter.split_text(doc.page_content)
    list_chunks.extend(chunks)

""" verify """
print(f"Number of Chunks: {len(list_chunks)}")
# print(f"Chunk-0: {list_chunks[0]}") # content

端到端演示​

请参阅我们的完整演示指南 Oracle AI 向量搜索端到端演示指南，以在 Oracle AI 向量搜索的帮助下构建端到端 RAG 管道。

此页面对您有帮助吗？


您也可以在 GitHub 上留下详细的反馈 GitHub.