Documentation Oracle Cloud Infrastructure

Modèles de configuration source

Découvrez les formats de fichier de configuration pour chaque source valide et l'objectif de chaque paramètre de configuration.

Rubriques

Fichier JSON

Le format du fichier de configuration pour le fichier JSON en tant que source de NoSQL Database Migrator est illustré ci-dessous.

Modèle de configuration

"source" : {
  "type" : "file",
  "format" : "json",
  "dataPath": "</path/to/a/json/file>",
  "schemaInfo": {
               "schemaPath": "</path/to/schema/file>"
  }
}

Paramètres source

type

  • Objet : Identifie le type de source.

  • Type de données : chaîne
  • Obligatoire (O/N) : Y

  • Exemple : "type" : "file"

format

  • Objectif : Indique le format source.

  • Type de données : chaîne
  • Obligatoire (O/N) : Y

  • Exemple : "format" : "json"

dataPath

  • Objectif : Indique le chemin absolu d'un fichier ou d'un répertoire contenant les données JSON à migrer.

    Vous devez vous assurer que ces données correspondent au schéma de table NoSQL défini au niveau du dissipateur. Si vous spécifiez un répertoire, NoSQL Database Migrator identifie tous les fichiers avec l'extension .json dans ce répertoire pour la migration. Les sous-répertoires ne sont pas pris en charge.

  • Type de données : chaîne
  • Obligatoire (O/N) : Y
  • Exemple :

    • Spécification d'un fichier JSON

      "dataPath" : "/home/user/sample.json"

    • Spécification d'un répertoire

      "dataPath" : "/home/user"

schemaInfo

  • Objectif : spécifie le schéma des données source en cours de migration. Ce schéma est transmis au dissipateur NoSQL.

  • Type de données : Objet
  • Obligatoire (O/N) : N

schemaInfo.schemaPath

  • Objectif : indique le chemin absolu du fichier de définition de schéma contenant des instructions DDL pour la table NoSQL en cours de migration.

  • Type de données : chaîne
  • Obligatoire (O/N) : Y
  • Exemple : 
    "schemaInfo" : {
            "schemaPath" : "/home/user/mytable/Schema/schema.ddl"
             }

Fichier JSON dans le bucket OCI Object Storage

Le format du fichier de configuration pour le fichier JSON dans le bucket OCI Object Storage en tant que source de NoSQL Database Migrator est indiqué ci-dessous.

Remarque

Les types de puits valides pour le type de source OCI Object Storage sont nosqldb et nosqldb_cloud.

Modèle de configuration

"source" : {
  "type" : "object_storage_oci",
  "format" : "json",
  "endpoint" : "<OCI Object Storage service endpoint URL or region ID>",
  "bucket" : "<bucket name>",
  "prefix" : "<object prefix>",
  "schemaInfo" : {
      "schemaObject" : "<object name>"
  },
  "credentials" : "</path/to/oci/config/file>",
  "credentialsProfile" : "<profile name in oci config file>",
  "useInstancePrincipal" : <true|false>
}

Paramètres source

type

  • Objet : Identifie le type de source.

  • Type de données : chaîne
  • Obligatoire (O/N) : Y

  • Exemple : "type" : "object_storage_oci"

format

  • Objectif : Indique le format source.

  • Type de données : chaîne
  • Obligatoire (O/N) : Y

  • Exemple : "format" : "json"

endpoint

  • Objectif : indique l'URL ou l'ID de région du service OCI Object Storage.

    You can either specify the complete URL or the Region ID alone. See Data Regions and Associated Service URLs in Using Oracle NoSQL Database Cloud Service for the list of data regions supported for Oracle NoSQL Database Cloud Service.

  • Type de données : chaîne
  • Obligatoire (O/N) : Y
  • Exemple :

    • ID de région : "endpoint" : "us-ashburn-1"

    • Format d'URL : "endpoint" : "https://objectstorage.us-ashburn-1.oraclecloud.com"

Catégorie

  • Objet : Indique le nom du bucket, qui contient les fichiers JSON source. Assurez-vous que le bucket requis existe déjà dans l'instance OCI Object Storage et dispose des droits d'accès en lecture.

  • Type de données : chaîne
  • Obligatoire (O/N) : Y

  • Exemple : "bucket" : "staging_bucket"

préfixe

  • Objectif : utilisé pour filtrer les objets en cours de migration à partir du bucket. Tous les objets avec le préfixe indiqué présents dans le bucket sont migrés. Pour plus d'informations sur les préfixes, reportez-vous à Dénomination des objets à l'aide de préfixes et de hiérarchies.

    Si vous ne fournissez aucune valeur, aucun filtre n'est appliqué et tous les objets présents dans le bucket sont migrés.

  • Type de données : chaîne
  • Obligatoire (O/N) : N
  • Exemple :
    1. "prefix" : "my_table/Data/000000.json" (migre uniquement 000000.json)
    2. "prefix" : "my_table/Data" (migre tous les objets avec le préfixe my_table/Data)

schemaInfo

  • Objectif : spécifie le schéma des données source en cours de migration. Ce schéma est transmis au dissipateur NoSQL.

  • Type de données : Objet
  • Obligatoire (O/N) : N

schemaInfo.schemaObject

  • Objectif : indique le nom de l'objet dans le bucket où sont stockées les définitions de schéma de table NoSQL des données en cours de migration.

  • Type de données : chaîne
  • Obligatoire (O/N) : Y
  • Exemple : 
    "schemaInfo" : {
            "schemaObject" : "mytable/Schema/schema.ddl"
             }

Informations d'identification

  • Objectif : chemin absolu vers un fichier contenant des informations d'identification OCI.

    S'il n'est pas spécifié, la valeur par défaut est $HOME/.oci/config

    Reportez-vous à Exemple de configuration pour obtenir un exemple de fichier d'informations d'identification.

    Remarque

    Même si les paramètres credentials et useInstancePrincipal ne sont pas obligatoires individuellement, l'un de ces paramètres DOIT être spécifié. En outre, ces deux paramètres sont mutuellement exclusifs. Indiquez UNIQUEMENT l'un de ces paramètres, mais pas les deux en même temps.
  • Type de données : chaîne
  • Obligatoire (O/N) : N
  • Exemple :
    1. "credentials" : "/home/user/.oci/config"
    2. "credentials" : "/home/user/security/config"

credentialsProfile

  • Objectif : nom du profil de configuration à utiliser pour la connexion à Oracle NoSQL Database Cloud Service. Les informations d'identification de compte utilisateur sont appelées "profil".

    Si vous n'indiquez pas cette valeur, le profil DEFAULT est défini par défaut.

    Remarque

    Ce paramètre est valide UNIQUEMENT si le paramètre credentials est spécifié.
  • Type de données : chaîne
  • Obligatoire (O/N) : N
  • Exemple :
    1. "credentialsProfile" : "DEFAULT"
    2. "credentialsProfile": "ADMIN_USER"

useInstancePrincipal

  • Objectif : indique si l'outil de migration NoSQL utilise l'authentification de principal d'instance pour se connecter à Oracle NoSQL Database Cloud Service. Pour plus d'informations sur la méthode d'authentification Principal d'instance, reportez-vous à Sécurité Source et Sink.

    Si elle n'est pas indiquée, la valeur par défaut est False.

    Remarque

    • Elle est prise en charge UNIQUEMENT lorsque l'outil NoSQL Database Migrator est exécuté dans une instance de calcul OCI, par exemple, l'outil NoSQL Database Migrator exécuté dans une machine virtuelle hébergée sur OCI.
    • Même si les paramètres credentials et useInstancePrincipal ne sont pas obligatoires individuellement, l'un de ces paramètres DOIT être spécifié. En outre, ces deux paramètres sont mutuellement exclusifs. Indiquez UNIQUEMENT l'un de ces paramètres, mais pas les deux en même temps.
  • Type de données : booléen
  • Obligatoire (O/N) : N

  • Exemple : "useInstancePrincipal" : true

Fichier JSON formaté MongoDB

Le format du fichier de configuration pour le fichier JSON formaté par MongoDB en tant que source de NoSQL Database Migrator est illustré ci-dessous.

Modèle de configuration

"source" : {
    "type" : "file",
    "format" : "mongodb_json",
    "dataPath": "</path/to/a/json/file>",
    "schemaInfo": {
               "schemaPath": "</path/to/schema/file>"
    }
}

Paramètres source

type

  • Objet : Identifie le type de source.

  • Type de données : chaîne
  • Obligatoire (O/N) : Y

  • Exemple : "type" : "file"

format

  • Objet : Indique le format source.

  • Type de données : chaîne
  • Obligatoire (O/N) : Y

  • Exemple : "format" : "mongodb_json"

dataPath

  • Objectif : Indique le chemin absolu d'un fichier ou d'un répertoire contenant les données JSON exportées MongoDB pour la migration.

    Vous devez avoir généré ces fichiers à l'aide de l'outil mongoexport. Reportez-vous à mongoexport pour plus d'informations.

    Vous pouvez fournir le fichier JSON au format MongoDB généré à l'aide de l'outil mongoexport en mode canonique ou relaxé. Les deux modes sont pris en charge par NoSQL Database Migrator pour la migration.

    Si vous spécifiez un répertoire, NoSQL Database Migrator identifie tous les fichiers avec l'extension .json dans ce répertoire pour la migration. Les sous-répertoires ne sont pas pris en charge. Vous devez vous assurer que ces données correspondent au schéma de table NoSQL défini au niveau du dissipateur.

  • Type de données : chaîne
  • Obligatoire (O/N) : Y
  • Exemple :

    • Spécification d'un fichier JSON au format MongoDB

      "dataPath" : "/home/user/sample.json"

    • Spécification d'un répertoire

      "dataPath" : "/home/user"

schemaInfo

  • Objectif : spécifie le schéma des données source en cours de migration. Ce schéma est transmis au dissipateur NoSQL.

  • Type de données : Objet
  • Obligatoire (O/N) : N

schemaInfo.schemaPath

  • Objectif : indique le chemin absolu du fichier de définition de schéma contenant des instructions DDL pour la table NoSQL en cours de migration.

  • Type de données : chaîne
  • Obligatoire (O/N) : Y
  • Exemple : 
    "schemaInfo" : {
            "schemaPath" : "/home/user/mytable/Schema/schema.ddl"
             }

Fichier JSON formaté MongoDB dans le bucket OCI Object Storage

Le format du fichier de configuration pour le fichier JSON formaté par MongoDB dans le bucket Object Storage OCI en tant que source de NoSQL Database Migrator est illustré ci-dessous.

Remarque

Les types de puits valides pour le type de source OCI Object Storage sont nosqldb et nosqldb_cloud.

Modèle de configuration

"source" : {
  "type" : "object_storage_oci",
  "format" : "mongodb_json",
  "endpoint" : "<OCI Object Storage service endpoint URL or region ID>",
  "bucket" : "<bucket name>",
  "prefix" : "<object prefix>",
  "schemaInfo" : {
      "schemaObject" : "<object name>"
  },
  "credentials" : "</path/to/oci/config/file>",
  "credentialsProfile" : "<profile name in oci config file>",
  "useInstancePrincipal" : <true|false>
}

Paramètres source

type

  • Objet : Identifie le type de source.

  • Type de données : chaîne
  • Obligatoire (Y/N) : Y

  • Exemple : "type" : "object_storage_oci"

format

  • Objet : Indique le format source.

  • Type de données : chaîne
  • Obligatoire (Y/N) : Y

  • Exemple : "format" : "mongodb_json"

endpoint

  • Objectif : indique l'URL ou l'ID de région du service OCI Object Storage.

    Vous pouvez indiquer l'URL complète ou l'ID de région seul. Reportez-vous à Régions de données et URL de service associées dans Utilisation d'Oracle NoSQL Database Cloud Service pour obtenir la liste des régions de données prises en charge pour Oracle NoSQL Database Cloud Service.

  • Type de données : chaîne
  • Obligatoire (Y/N) : Y
  • Exemple :

    • ID de région : "endpoint" : "us-ashburn-1"

    • Format d'URL : "endpoint" : "https://objectstorage.us-ashburn-1.oraclecloud.com"

intervalle

  • Objectif : Indique le nom du bucket, qui contient les fichiers JSON source formatés par MongoDB. Assurez-vous que le bucket requis existe déjà dans l'instance OCI Object Storage et dispose des droits d'accès en lecture.

  • Type de données : chaîne
  • Obligatoire (Y/N) : Y

  • Exemple : "bucket" : "staging_bucket"

préfixe

  • Objectif : utilisé pour filtrer les objets en cours de migration à partir du bucket. Tous les objets avec le préfixe indiqué présents dans le bucket sont migrés. Pour plus d'informations sur les préfixes, reportez-vous à Dénomination des objets à l'aide de préfixes et de hiérarchies.

    Si vous ne fournissez aucune valeur, aucun filtre n'est appliqué et tous les objets formatés JSON MongoDB présents dans le bucket sont migrés. Extrayez les données de MongoDB à l'aide de l'utilitaire mongoexport et téléchargez-les vers le bucket OCI Object Storage. Reportez-vous à mongoexport pour plus d'informations.

    Si vous ne fournissez aucune valeur, aucun filtre n'est appliqué et tous les objets présents dans le bucket sont migrés.

  • Type de données : chaîne
  • Obligatoire (O/N) : N
  • Exemple :
    1. "prefix" : "mongo_export/Data/table.json" (migre uniquement table.json)
    2. "prefix" : "mongo_export/Data" (migre tous les objets avec le préfixe mongo_export/Data)

schemaInfo

  • Objectif : spécifie le schéma des données source en cours de migration. Ce schéma est transmis au dissipateur NoSQL.

  • Type de données : Objet
  • Obligatoire (O/N) : N

schemaInfo.schemaObject

  • Objectif : indique le nom de l'objet dans le bucket où sont stockées les définitions de schéma de table NoSQL des données en cours de migration.

  • Type de données : chaîne
  • Obligatoire (Y/N) : Y
  • Exemple : 
    "schemaInfo" : {
            "schemaObject" : "mytable/Schema/schema.ddl"
             }

Informations d'identification

  • Objectif : chemin absolu vers un fichier contenant des informations d'identification OCI.

    S'il n'est pas spécifié, la valeur par défaut est $HOME/.oci/config

    Pour obtenir un exemple de fichier d'informations d'identification, reportez-vous à Exemple de configuration.

    Remarque

    Même si les paramètres credentials et useInstancePrincipal ne sont pas obligatoires individuellement, l'un de ces paramètres DOIT être spécifié. En outre, ces deux paramètres sont mutuellement exclusifs. Indiquez UNIQUEMENT l'un de ces paramètres, mais pas les deux en même temps.
  • Type de données : chaîne
  • Obligatoire (O/N) : N
  • Exemple :
    1. "credentials" : "/home/user/.oci/config"
    2. "credentials" : "/home/user/security/config"

credentialsProfile

  • Objectif : nom du profil de configuration à utiliser pour la connexion à Oracle NoSQL Database Cloud Service. Les informations d'identification de compte utilisateur sont appelées "profil".

    Si vous n'indiquez pas cette valeur, le profil DEFAULT est défini par défaut.

    Remarque

    Ce paramètre est valide UNIQUEMENT si le paramètre credentials est spécifié.
  • Type de données : chaîne
  • Obligatoire (O/N) : N
  • Exemple :
    1. "credentialsProfile" : "DEFAULT"
    2. "credentialsProfile": "ADMIN_USER"

useInstancePrincipal

  • Objectif : indique si l'outil de migration NoSQL utilise l'authentification de principal d'instance pour se connecter à Oracle NoSQL Database Cloud Service. Pour plus d'informations sur la méthode d'authentification Principal d'instance, reportez-vous à Sécurité Source et Sink.

    Si elle n'est pas indiquée, la valeur par défaut est False.

    Remarque

    • Elle est prise en charge UNIQUEMENT lorsque l'outil NoSQL Database Migrator est exécuté dans une instance de calcul OCI, par exemple, l'outil NoSQL Database Migrator exécuté dans une machine virtuelle hébergée sur OCI.
    • Bien que les informations d'identification et les paramètres useInstancePrincipal ne soient pas obligatoires individuellement, l'un de ces paramètres DOIT être spécifié. En outre, ces deux paramètres sont mutuellement exclusifs. Indiquez UNIQUEMENT l'un de ces paramètres, mais pas les deux en même temps.
  • Type de données : booléen
  • Obligatoire (O/N) : N

  • Exemple : "useInstancePrincipal" : true

Oracle NoSQL Database

Le format de fichier de configuration d'Oracle NoSQL Database en tant que source de NoSQL Database Migrator est illustré ci-dessous.

Modèle de configuration

"source" : {
    "type": "nosqldb",
    "table" : "<fully qualified table name>",
    "storeName" : "<store name>",
    "helperHosts" : ["hostname1:port1","hostname2:port2,..."],
    "security" : "</path/to/store/security/file>",
    "requestTimeoutMs" : 5000,
    "includeTTL": <true|false>
}

Paramètres source

type

  • Objectif : identifie le type de source.

  • Type de données : chaîne
  • Obligatoire (Y/N) : Y

  • Exemple : "type" : "nosqldb"

table

  • Objectif : Nom de table complet à partir duquel migrer les données.

    Format : [namespace_name:]<table_name>

    Si la table se trouve dans l'espace de noms DEFAULT, vous pouvez omettre namespace_name. La table doit exister dans le magasin.

  • Type de données : chaîne
  • Obligatoire (Y/N) : Y
  • Exemple :

    • Avec l'espace de noms DEFAULT "table" :"mytable"

    • Avec un espace de noms autre que par défaut "table" : "mynamespace:mytable"

storeName

  • Objectif : Nom du magasin Oracle NoSQL Database.

  • Type de données : chaîne
  • Obligatoire (Y/N) : Y
  • Exemple : "storeName" : "kvstore"

helperHosts

  • Objectif : Liste des paires hôte et port de registre au format hostname:port. Délimitez chaque élément de la liste par une virgule. Vous devez indiquer au moins un hôte d'assistance.

  • Type de données : tableau de chaînes
  • Obligatoire (Y/N) : Y
  • Exemple : "helperHosts" : ["localhost:5000","localhost:6000"]

Sécurité

  • Objectif :

    Si votre magasin est un magasin sécurisé, indiquez le chemin absolu du fichier de connexion de sécurité contenant vos informations d'identification de magasin. Reportez-vous à la section Configuring Security with Remote Access in Administrator's Guide pour en savoir plus sur le fichier de connexion de sécurité.

    Vous pouvez utiliser l'authentification basée sur un fichier de mots de passe ou l'authentification basée sur un portefeuille. Toutefois, l'authentification basée sur le portefeuille n'est prise en charge que dans Enterprise Edition (EE) d'Oracle NoSQL Database. Pour plus d'informations sur l'authentification basée sur un portefeuille, reportez-vous à la section Source and Sink Security.

    L'édition Community Edition(CE) prend uniquement en charge l'authentification basée sur un fichier de mots de passe.

  • Type de données : chaîne
  • Obligatoire (O/N) : Y pour un magasin sécurisé
  • Exemple :

    "security" : "/home/user/client.credentials"

    Exemple de contenu de fichier de sécurité pour l'authentification basée sur un fichier de mots de passe :

    oracle.kv.password.noPrompt=true
oracle.kv.auth.username=admin
oracle.kv.auth.pwdfile.file=/home/nosql/login.passwd
oracle.kv.transport=ssl
oracle.kv.ssl.trustStore=/home/nosql/client.trust
oracle.kv.ssl.protocols=TLSv1.2
oracle.kv.ssl.hostnameVerifier=dnmatch(CN\=NoSQL)

    Exemple de contenu du fichier de sécurité pour l'authentification basée sur un portefeuille : 

    oracle.kv.password.noPrompt=true
oracle.kv.auth.username=admin
oracle.kv.auth.wallet.dir=/home/nosql/login.wallet
oracle.kv.transport=ssl
oracle.kv.ssl.trustStore=/home/nosql/client.trust
oracle.kv.ssl.protocols=TLSv1.2
oracle.kv.ssl.hostnameVerifier=dnmatch(CN\=NoSQL)

requestTimeoutMs

  • Objectif : Indique la durée d'attente de chaque opération de lecture à partir du magasin. Elle est fournie en millisecondes. La valeur par défaut est 5000. Il doit s'agir d'un entier positif.

  • Type de données : entier
  • Obligatoire (O/N) : N
  • Exemple : "requestTimeoutMs" : 5000

includeTTL

  • Objectif : indique si les métadonnées de durée de vie des lignes de table doivent être incluses lors de l'export des tables Oracle NoSQL Database. Si la valeur est True, les données de durée de vie des lignes sont également incluses dans les données fournies par la source. La durée de vie est présente dans l'objet JSON _metadata associé à chaque ligne. Le délai d'expiration de chaque ligne est exporté en millisecondes depuis la période UNIX (1er janvier 1970).

    Si vous n'indiquez pas ce paramètre, la valeur par défaut est false.

    Seules les lignes ayant une valeur d'expiration positive pour la durée de vie sont incluses dans les lignes exportées. Si une ligne n'expire pas, ce qui signifie TTL=0, ses métadonnées de durée de vie ne sont pas incluses explicitement. Par exemple, si ROW1 expire à 2021-10-19 00:00:00 et que ROW2 n'expire pas, les données exportées se présentent comme suit :
    //ROW1
{
  "id" : 1,
  "name" : "abc",
  "_metadata" : {
    "expiration" : 1634601600000
  }
}

//ROW2
{
  "id" : 2,
  "name" : "xyz"
}
  • Type de données : booléen
  • Obligatoire (O/N) : N
  • Exemple : "includeTTL" : true

Oracle NoSQL Database Cloud Service

Le format de fichier de configuration d'Oracle NoSQL Database Cloud Service en tant que source de NoSQL Database Migrator est indiqué ci-dessous.

Modèle de configuration

"source" : {
  "type" : "nosqldb_cloud",
  "endpoint" : "<Oracle NoSQL Cloud Service Endpoint. You can either specify  the complete URL or the Region ID alone>",
  "table" : "<table name>",
  "compartment" : "<OCI compartment name or id>",
  "credentials" : "</path/to/oci/credential/file>",
  "credentialsProfile" : "<oci credentials profile name>",
  "readUnitsPercent" : <table readunits percent>,
  "requestTimeoutMs" : <timeout in milli seconds>,
  "useInstancePrincipal" : <true|false>,
  "includeTTL": <true|false>
}

Paramètres source

type

  • Objectif : identifie le type de source.

  • Type de données : chaîne
  • Obligatoire (Y/N) : Y

  • Exemple : "type" : "nosqldb_cloud"

endpoint

  • Objectif : indique l'adresse de service d'Oracle NoSQL Database Cloud Service.

    Vous pouvez indiquer l'URL complète ou l'ID de région seul. Reportez-vous à Régions de données et URL de service associées dans Utilisation d'Oracle NoSQL Database Cloud Service pour obtenir la liste des régions de données prises en charge pour Oracle NoSQL Database Cloud Service.

  • Type de données : chaîne
  • Obligatoire (Y/N) : Y
  • Exemple :

    • ID de région : "endpoint" : "us-ashburn-1"

    • Format d'URL : "endpoint" : "https://nosql.us-ashburn-1.oci.oraclecloud.com/"

table

  • Objectif : Nom de la table à partir de laquelle migrer les données.

  • Type de données : chaîne
  • Obligatoire (Y/N) : Y
  • Exemple : "table" :"myTable"

compartiment

  • Objectif : indique le nom ou l'OCID du compartiment dans lequel réside la table.

    Si vous n'indiquez aucune valeur, le compartiment root est défini par défaut.

    Vous pouvez trouver l'OCID de votre compartiment dans la fenêtre Explorateur de compartiment, sous Gouvernance, dans la console OCI Cloud.

  • Type de données : chaîne
  • Obligatoire (Y/N) : Oui, si la table ne se trouve pas dans le compartiment racine de la location OU lorsque le paramètre useInstancePrincipal est défini sur True.
    Remarque

    Si le paramètre useInstancePrincipal est défini sur True, le compartiment doit indiquer l'OCID de compartiment et non le nom.
  • Exemple :

    • Nom de compartiment

      "compartment" : "mycompartment"

    • Nom de compartiment qualifié avec son compartiment parent

      "compartment" : "parent.childcompartment"

    • Aucune valeur fournie. La valeur par défaut est le compartiment racine.

      "compartment": ""

    • OCID de compartiment

      "compartment" : "ocid1.tenancy.oc1...4ksd"

Informations d'identification

  • Objectif : chemin absolu vers un fichier contenant des informations d'identification OCI.

    S'il n'est pas spécifié, la valeur par défaut est $HOME/.oci/config

    Pour obtenir un exemple de fichier d'informations d'identification, reportez-vous à Exemple de configuration.

    Remarque

    Même si les paramètres credentials et useInstancePrincipal ne sont pas obligatoires individuellement, l'un de ces paramètres DOIT être spécifié. En outre, ces deux paramètres sont mutuellement exclusifs. Indiquez UNIQUEMENT l'un de ces paramètres, mais pas les deux en même temps.
  • Type de données : chaîne
  • Obligatoire (O/N) : N
  • Exemple :
    1. "credentials" : "/home/user/.oci/config"
    2. "credentials" : "/home/user/security/config"

credentialsProfile

  • Objectif : nom du profil de configuration à utiliser pour la connexion à Oracle NoSQL Database Cloud Service. Les informations d'identification de compte utilisateur sont appelées "profil".

    Si vous n'indiquez pas cette valeur, le profil DEFAULT est défini par défaut.

    Remarque

    Ce paramètre est valide UNIQUEMENT si le paramètre credentials est spécifié.
  • Type de données : chaîne
  • Obligatoire (O/N) : N
  • Exemple :
    1. "credentialsProfile" : "DEFAULT"
    2. "credentialsProfile": "ADMIN_USER"

readUnitsPercent

  • Objectif : Pourcentage d'unités de lecture de table à utiliser lors de la migration de la table NoSQL.

    La valeur par défaut est 90. La plage valide est n'importe quel entier compris entre 1 et 100. La durée de migration des données est directement proportionnelle à cet attribut. Il est préférable d'augmenter le débit de lecture de la table pour l'activité de migration. Vous pouvez réduire le débit de lecture une fois le processus de migration terminé.

    Pour connaître les limites quotidiennes relatives aux modifications de débit, reportez-vous à Limites cloud dans Utilisation d'Oracle NoSQL Database Cloud Service.

    La valeur par défaut est 90. La plage valide est n'importe quel entier compris entre 1 et 100.

    Remarque

    Le temps requis pour la migration des données est directement proportionnel à la valeur writeUnitsPercent.

    Reportez-vous à la section Troubleshooting the Oracle NoSQL Database Migrator pour savoir comment utiliser cet attribut pour améliorer la vitesse de migration des données.

  • Type de données : entier
  • Obligatoire (O/N) : N
  • Exemple : "readUnitsPercent" : 90

requestTimeoutMs

  • Objectif : Indique la durée d'attente de chaque opération de lecture dans le dissipateur. Elle est fournie en millisecondes. La valeur par défaut est 5000. Il doit s'agir d'un entier positif.

  • Type de données : entier
  • Obligatoire (O/N) : N
  • Exemple : "requestTimeoutMs" : 5000

useInstancePrincipal

  • Objectif : indique si l'outil de migration NoSQL utilise l'authentification de principal d'instance pour se connecter à Oracle NoSQL Database Cloud Service. Pour plus d'informations sur la méthode d'authentification Principal d'instance, reportez-vous à Sécurité Source et Sink.

    Si elle n'est pas indiquée, la valeur par défaut est False.

    Remarque

    • Elle est prise en charge UNIQUEMENT lorsque l'outil NoSQL Database Migrator est exécuté dans une instance de calcul OCI, par exemple, l'outil NoSQL Database Migrator exécuté dans une machine virtuelle hébergée sur OCI.
    • Même si les paramètres credentials et useInstancePrincipal ne sont pas obligatoires individuellement, l'un de ces paramètres DOIT être spécifié. En outre, ces deux paramètres sont mutuellement exclusifs. Indiquez UNIQUEMENT l'un de ces paramètres, mais pas les deux en même temps.
  • Type de données : booléen
  • Obligatoire (O/N) : N

  • Exemple : "useInstancePrincipal" : true

includeTTL

  • Objectif : indique si les métadonnées de durée de vie des lignes de table doivent être incluses lors de l'export des tables Oracle NoSQL Database Cloud Service. Si la valeur est True, les données de durée de vie des lignes sont également incluses dans les données fournies par la source. La durée de vie est présente dans l'objet JSON _metadata associé à chaque ligne. Le délai d'expiration de chaque ligne est exporté en millisecondes depuis la période UNIX (1er janvier 1970).

    Si vous n'indiquez pas ce paramètre, la valeur par défaut est false.

    Seules les lignes ayant une valeur d'expiration positive pour la durée de vie sont incluses dans les lignes exportées. Si une ligne n'expire pas, ce qui signifie TTL=0, ses métadonnées de durée de vie ne sont pas incluses explicitement. Par exemple, si ROW1 expire à 2021-10-19 00:00:00 et que ROW2 n'expire pas, les données exportées se présentent comme suit :
    //ROW1
{
  "id" : 1,
  "name" : "abc",
  "_metadata" : {
    "expiration" : 1634601600000
  }
}

//ROW2
{
  "id" : 2,
  "name" : "xyz"
}
  • Type de données : booléen
  • Obligatoire (O/N) : N
  • Exemple : "includeTTL" : true