关于 OCI SDK API

Oracle Cloud Infrastructure 提供了许多软件开发工具包 (SDK)，以促进定制解决方案的开发。

软件开发工具包 (SDK) 用于构建和部署与 Oracle Cloud Infrastructure 服务集成的应用。不同的 OCI SDK 支持 Java、Python、Go、.NET、Typescript、Javascript 和 Ruby。每个 SDK 提供了开发应用所需的工具，包括用于创建、测试和故障排除的代码示例和文档。借助 Oracle Cloud Infrastructure SDK，您可以编写代码来管理 Oracle Cloud Infrastructure 资源。

使用 OCI SDK API

要使用 OCI SDK，您必须具有以下各项：

Oracle Cloud Infrastructure 账户。
在组中的该账户中创建的具有授予所需权限的策略的用户。这可以是您自己的用户，也可以是需要调用 API 的其他人员/系统。

适用于 Java 的 OCI SDK：您可以在此处下载适用于 Java 的 OCI SDK。除了上述要求外，还需要安装 Java 版本 8 或更高版本。有关更多详细信息，请参阅 SDK for Java 。

注： OCI SDK 还适用于 Python、Go、Typescript、Javascript、.NET 和 Ruby。请参阅 OCI SDK 指南。

使用 OCI Java SDK 创建单例表

可以在 createTable 方法内使用 CreateTableRequest 类来创建新的 NoSQL 表。

以下代码片段展示了如何使用 OCI Java SDK 创建单例表。

private static final String DEF_OCI_CONFIG = "~/.oci/config";
private static final String DEF_PROFILE = "DEFAULT";
String tableName = "<table_name>";
String region = "<region_name>";

/* Initialize NoSQLHandle */
   NosqlClient client = connect(endpoint, DEF_OCI_CONFIG, DEF_PROFILE);

/* Create table */
   String ddl = "CREATE TABLE IF NOT EXISTS " + tableName + "(" +
                     "id INTEGER, info JSON, PRIMARY KEY(id)) " ;
   TableLimits limits = TableLimits.builder()
                .maxReadUnits(50)
                .maxWriteUnits(50)
                .maxStorageInGBs(1)
                .build();
   CreateTableDetails.Builder payload = CreateTableDetails.builder()
                .compartmentId(compartmentId)
                .name(tableName)
                .ddlStatement(ddl)
                .tableLimits(limits);
   CreateTableRequest tableReq = CreateTableRequest.builder()
                .createTableDetails(payload.build())
                .build();
   CreateTableResponse tableRes = client.createTable(tableReq);
        output("\nCreating table: " + ddl);
        waitForComplete(client, tableRes.getOpcWorkRequestId());
        output("Table created: " + tableName);

使用 OCI Java SDK 创建全局活动表

您可以使用 OCI Java SDK 在 NDCS 中创建全局活动表。

要创建全局活动表，请执行以下操作：

创建包含至少一个 JSON 列的 NoSQL 表。
冻结表的方案。通过使用在 DDL CREATE TABLE 语句中冻结的方案进行添加，可以冻结表创建时。
只有在添加区域副本表之后，NoSQL 数据库表才会成为全局活动表。区域副本表是在另一个区域中创建的。

以下代码片段显示了如何使用 OCI Java SDK 创建全局活动表。

private static final String DEF_OCI_CONFIG = "~/.oci/config";
private static final String DEF_PROFILE = "DEFAULT";
String tableName = "<table_name>";
String region = "<region_name>";

/* Initialize NoSQLHandle */
   NosqlClient client = connect(endpoint, DEF_OCI_CONFIG, DEF_PROFILE);

/* Create table */
   String ddl = "CREATE TABLE IF NOT EXISTS " + tableName + "(" +
                     "id INTEGER, info JSON, PRIMARY KEY(id)) " +
                     "with schema frozen";
   TableLimits limits = TableLimits.builder()
                .maxReadUnits(50)
                .maxWriteUnits(50)
                .maxStorageInGBs(1)
                .build();
   CreateTableDetails.Builder payload = CreateTableDetails.builder()
                .compartmentId(compartmentId)
                .name(tableName)
                .ddlStatement(ddl)
                .tableLimits(limits);
   CreateTableRequest tableReq = CreateTableRequest.builder()
                .createTableDetails(payload.build())
                .build();
   CreateTableResponse tableRes = client.createTable(tableReq);
        output("\nCreating table: " + ddl);
        waitForComplete(client, tableRes.getOpcWorkRequestId());
        output("Table created: " + tableName);

/* Add replica ca-montreal-1 */
   CreateReplicaDetails info = CreateReplicaDetails
                .builder()
                .region(region)
                .compartmentId(compartmentId)
                .build();
   CreateReplicaRequest replicaReq = CreateReplicaRequest
                .builder()
                .tableNameOrId(tableName)
                .createReplicaDetails(info)
                .build();
   CreateReplicaResponse replicaRes = client.createReplica(replicaReq);
        output("\nAdding replica: " + region);
        waitForComplete(client, replicaRes.getOpcWorkRequestId());
        output("Added replica: " + region);