À propos des API de trousse SDK OCI

Oracle Cloud Infrastructure fournit un certain nombre de kits de développement logiciel (SDK) pour faciliter le développement de solutions personnalisées.

Les kits de développement logiciel (SDK) sont utilisés pour créer et déployer des applications intégrant les services Oracle Cloud Infrastructure. Différentes trousses SDK pour OCI prennent en charge Java, Python, Go, .NET, Typescript, Javascript et Ruby. Chaque SDK fournit les outils nécessaires au développement d'une application, y compris des exemples de code et de la documentation, pour la création, les tests et le diagnostic. La SDK Oracle Cloud Infrastructure vous permet d'écrire du code pour gérer les ressources Oracle Cloud Infrastructure.

Utilisation des API de la trousse SDK OCI

Pour utiliser les trousses SDK pour OCI, vous devez avoir :
  • Un compte Oracle Cloud Infrastructure.
  • Utilisateur qui est créé dans ce compte dans un groupe avec une politique qui accorde les autorisations souhaitées. Il peut s'agir d'un utilisateur pour vous-même, une autre personne ou un autre système qui doit appeler l'API.
SDK OCI pour Java : Vous pouvez télécharger la trousse SDK OCI pour Java ici. En plus des exigences ci-dessus, vous devez installer Java version 8 ou supérieure. Pour plus de détails, voir Trousse SDK pour Java.

Note :

La trousse SDK pour OCI est également disponible pour Python, Go, Typescript, Javascript, .NET et Ruby. Pour plus de détails, voir Guides sur la trousse SDK pour OCI.

Création d'une table singleton à l'aide de la trousse SDK Java pour

Vous pouvez utiliser la classe CreateTableRequest dans une méthode createTable pour créer une nouvelle table NoSQL.

L'extrait de code suivant montre comment utiliser la trousse SDK Java pour OCI pour créer une table singleton.
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);

Création d'une table globale active à l'aide de la trousse SDK Java pour

Vous pouvez utiliser la trousse SDK Java pour OCI pour créer une table globale active dans NDCS.

Pour créer une table globale active :
  • Créez une table NoSQL avec au moins une colonne JSON.
  • Geler le schéma de la table. Vous pouvez geler la table lors de sa création en l'ajoutant avec un schéma gelé dans l'instruction DDL CREATE TABLE.
  • Une table de base de données NoSQL devient une table active globale uniquement après l'ajout d'une table de réplique régionale. La table de réplique régionale est créée dans une autre région.
L'extrait de code suivant montre comment créer une table Global Active à l'aide de la trousse SDK Java pour OCI.
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);