将 JSON 文档与 Autonomous Database on Dedicated Exadata Infrastructure 结合使用

Autonomous Database on Dedicated Exadata Infrastructure 支持 JavaScript 对象表示法 (Object Notation，JSON) 数据，具有关系数据库功能，包括事务处理、索引、声明式查询和视图。在自治数据库中，JSON 文档可以与关系数据共存。

与关系数据不同，JSON 数据可以存储在数据库中、对数据进行索引和查询，而无需定义数据的方案。通常，在 Autonomous Database 中处理 JSON 数据时，您将执行以下任务：
  1. 创建具有 is json format oson check 约束条件的 JSON 列
  2. 将 JSON 数据插入到列中，以及
  3. 查询 JSON 数据
有关包含代码示例的详细说明，请参阅 Oracle Database 19c JSON Developer's Guide 或 Oracle Database 23ai JSON Developer's Guide 中的 Work with JSON Documents in Autonomous Database 。

注意：

如果您使用 SODA 访问 Oracle Database 19c 中的集合，Oracle 建议您将即时客户端用于 Oracle Database 21c 或更高版本，以便在数据库升级到发行版 21 或更高版本时，顺利迁移到使用 JSON 数据类型。

SQL 和 PL/SQL API

使用 an Autonomous Database 存储 JSON 数据时，您可以充分利用 Autonomous Database 中提供的所有功能。您可以将 JSON 数据与非 JSON 数据组合在一起。您可以像访问其他数据库数据一样访问数据库中存储的 JSON 数据，包括使用 Oracle Call Interface (OCI)、Microsoft .NET Framework 和 Java Database Connectivity (JDBC)。要了解如何使用 SQL 和 PL/SQL API 处理 JSON 文档，请参阅 Oracle Database 19c 或 Oracle Database 23ai 中的 JSON 。

Oracle API for MongoDB 支持

Oracle Database API for MongoDB 将 MongoDB 线协议转换为由 Oracle Database 执行的 SQL 语句。它允许拥有 MongoDB 技能集的开发人员为 Oracle Database 编写 JSON 文档存储应用程序，这些应用程序使用了解 MongoDB 协议的驱动程序和工具。有关此 API 的详细概述，请参阅 Oracle Database API for MongoDB 中的 Oracle Database API for MongoDB 概述。

有关在 Autonomous Database 中启用和使用 MongoDB API 的说明，请参阅将 MongoDB API 与 Oracle Autonomous Database 结合使用。

简单 Oracle 文档访问 (SODA)

Oracle 还提供一系列简单 Oracle 文档访问 (SODA) API，用于访问数据库中存储的 JSON 数据。SODA 专为无模式应用开发而设计，不了解关系数据库功能或 SQL 和 PL/SQL 等语言。它允许您在 Oracle Database 中创建和存储文档集合、检索和查询它们，而无需知道文档在数据库中的存储方式。有关 SODA 的更多信息，请参见 Oracle as a Document Store 和 SODA 概览。

SODA 有几个实现：
  • SODA for REST ：表示状态传输 (REST) 请求使用任何能够进行 HTTP 调用的语言执行收集和文档操作。
  • SODA for Java ：Java 类和接口表示数据库、集合和文档。
  • SODA for PL/SQL ：PL/SQL 对象类型表示集合和文档。
  • SODA for C ：Oracle Call Interface (OCI) 处理表示集合和文档。
  • SODA for Node.js ：NoSQL 样式的 SODA API 用于插入、查询和检索 SODA 文档。SodaDatabase、SodaCollection、SodaDocument、SodaDocumentCursor 和 SodaOperation 等对象分别表示数据库、集合、文档、文档光标和读写操作。
  • SODA for Python ：NoSQL 样式的 cx_Oracle 方法用于插入、查询和检索 SODA 文档。SodaDatabase、SodaCollection、SodaDocument、SodaDocumentCursor 和 SodaOperation 等对象分别表示数据库、集合、文档、文档光标和读写操作。
您可以从 an Autonomous Database 的详细信息页面下载 SODA 驱动程序。
  • 访问 Autonomous Database 的详细信息页面。请参阅查看专用 Autonomous Database 的详细信息。
  • 打开 Tools 选项卡。
  • 找到 SODA 驱动程序磁贴，然后单击下载 SODA 驱动程序。
  • 从显示的驱动程序列表中下载您选择的 SODA 驱动程序。

SODA 收集元数据

SODA 集合是一组由 Autonomous Database 表或视图支持的文档。默认情况下，创建 SODA 文档集合会在 Oracle Database 中创建以下内容：
  • 持久性缺省收集 metadata 。
  • 用于将集合存储在 SODA 客户机连接到的数据库方案中的表。
您可以对收集元数据进行定制，以获得与缺省情况下提供的行为不同的行为。您可以在 Autonomous Database 中定制的唯一元数据是文档密钥生成方法和内容介质类型。特别是，您无法更改用于存储 JSON 内容的列的 SQL 数据类型（内容列）。要了解如何使用默认和定制的收集元数据，请参阅 SODA Collection Metadata on Autonomous Database 。

对使用 SODA 和 JSON 的限制

Autonomous Database 支持 SODA 和 JSON，但存在以下限制：
  • 使用 SQL/JSON 函数 json_exists 的 SQL 和 PL/SQL 代码不支持自动索引。有关详细信息，请参阅 Oracle Database 19c 或 Oracle Database 23ai 中的 SQL/JSON 条件 JSON_EXISTS 。
  • SODA 按实例查询 (QBE) 不支持自动索引。

相关主题