Utilisation de l'interface de ligne de commande (CLI)
Utilisez l'interface de ligne de commande pour créer des connexions Database Tools.
Pour plus d'informations sur l'utilisation de l'interface de ligne de commande, reportez-vous à Interface de ligne de commande (CLI). Afin d'obtenir la liste complète des indicateurs et des options disponibles pour les commandes d'interface de ligne de commande, reportez-vous à Référence de ligne de commande.
Rubriques :
Pour les connexions Oracle Database
- Pour créer une connexion à ADB avec une adresse IP publique à l'aide de mTLS
- Procédure de création d'une connexion à ADB avec une adresse IP publique à l'aide de mTLS dans un fichier JSON
- Procédure de création d'une connexion à un système de base de données Oracle VM à l'aide d'une adresse privée
- Pour créer une connexion proxy à Oracle Database avec un nom utilisateur
- Procédure de création d'une connexion proxy à Oracle Database avec des propriétés avancées
- Pour créer une connexion proxy à Oracle Database à l'aide du paramètre proxy-client
- Pour créer une connexion proxy à Oracle Database avec le paramètre proxy-client dans un fichier JSON
Pour créer une connexion à ADB avec une adresse IP publique à l'aide de mTLS
Ouvrez une invite de commande et exécutez oci dbtools connection create-oracle-database pour créer une connexion Database Tools dans le compartiment indiqué :
oci dbtools connection create-oracle-database -c <target_compartment_ocid> --user-name <database_user> --user-password-secret-id <vault_secret_ocid> --key-stores <keystore_json_array> --connection-string <connection_string> --display-name <connection_name> Remarque
Cet exemple suppose que les clés secrètes requises existent déjà dans un coffre.
Cet exemple suppose que les clés secrètes requises existent déjà dans un coffre.
Par exemple, spécifiez tous les détails requis en tant qu'arguments :
oci dbtools connection create-oracle-database -c ocid1.compartment.oc1..example1example25qrlpo4agcmothkbgqgmuz2zzum45ibplooqtabwk3zz --user-name "example-user" --user-password-secret-id ocid1.vaultsecret.oc1.phx.example1secrettxiu7mwuabcdefxl67fj5niy4akfzsabcdefzf3423ya --key-stores '[{ "keyStoreContent":{ "secretId": "ocid1.vaultsecret.oc1.phx.example1ssowalletxiu7mwuabcdefxl67fj5niy4akfzsabcdefzf3423ya","valueType": "SECRETID" }, "keyStoreType": "SSO" }]' --connection-string '(description= (retry_count=20)(retry_delay=3)(address=(protocol=tcps)(port=1522)(host=adb.us-phoenix-1.oraclecloud.com))(connect_data=(service_name=example_databaseservice_low.adb.oraclecloud.com))(security=(ssl_server_cert_dn="CN=adwc.uscom-east-1.oraclecloud.com, OU=Oracle BMCS US, O=Oracle Corporation, L=Redwood City, ST=California, C=US")))' --display-name example-connection
Procédure de création d'une connexion à ADB avec une adresse IP publique à l'aide de mTLS dans un fichier JSON
Ouvrez une invite de commande et exécutez oci dbtools connection create-oracle-database pour créer une connexion Database Tools comme indiqué dans le fichier JSON :
oci dbtools connection create-oracle-database --from-json "file://<path-to-json>" Remarque
Cet exemple suppose que les clés secrètes requises existent déjà dans un coffre.
Cet exemple suppose que les clés secrètes requises existent déjà dans un coffre.
Par exemple, en spécifiant tous les détails requis dans un fichier JSON :
{
"compartmentId": "ocid1.compartment.oc1..example1example25qrlpo4agcmothkbgqgmuz2zzum45ibplooqtabwk3zz",
"connectionString": "(description= (retry_count=20)(retry_delay=3)(address=(protocol=tcps)(port=1522)(host=adb.us-phoenix-1.oraclecloud.com))
(connect_data=(service_name=example_databaseservice_low.adb.oraclecloud.com))
(security=(ssl_server_cert_dn=\"CN=adwc.uscom-east-1.oraclecloud.com, OU=Oracle BMCS US, O=Oracle Corporation, L=Redwood City, ST=California, C=US\")))",
"displayName": "example-connection-from-json",
"keyStores": [
{
"keyStoreContent": {
"secretId": "ocid1.vaultsecret.oc1.phx.example1ssowalletxiu7mwuabcdefxl67fj5niy4akfzsabcdefzf3423ya",
"valueType": "SECRETID"
},
"keyStoreType": "SSO"
}
],
"userName": "example-user",
"userPasswordSecretId": "ocid1.vaultsecret.oc1.phx.example1secrettxiu7mwuabcdefxl67fj5niy4akfzsabcdefzf3423ya"
} Remarque
Dans cet exemple, il existe un fichier JSON dans le répertoire de travail en cours nommé
Dans cet exemple, il existe un fichier JSON dans le répertoire de travail en cours nommé
example.json, comme indiqué ci-dessus.
oci dbtools connection create-oracle-database --from-json "file://example.json"Procédure de création d'une connexion à un système de base de données Oracle VM à l'aide d'une adresse privée
Ouvrez une invite de commande et exécutez oci dbtools connection create-oracle-database pour créer une connexion Database Tools dans le compartiment indiqué :
oci dbtools connection create-oracle-database -c <target_compartment_ocid> --user-name <database_user> --user-password-secret-id <vault_secret_ocid> --connection-string <connection_string> -private-endpoint-id <private_endpoint_ocid> --display-name <connection_name>
Remarque
Cet exemple suppose que les clés secrètes requises existent déjà dans un coffre.
Cet exemple suppose que les clés secrètes requises existent déjà dans un coffre.
Par exemple :
oci dbtools connection create-oracle-database -c ocid1.compartment.oc1..example1example25qrlpo4agcmothkbgqgmuz2zzum45ibplooqtabwk3zz --user-name "example-user" --user-password-secret-id ocid1.vaultsecret.oc1.phx.example1secrettxiu7mwuabcdefxl67fj5niy4akfzsabcdefzf3423ya --connection-string "examplevmdb.privatesubnet.example.oraclevcn.com:1521/example_pdb.privatesubnet.example.oraclevcn.com" --private-endpoint-id ocid1.databasetoolsprivateendpoint.oc1.phx.exampleendpoint25qrlpo4agcmothkbgqgmuz2zzum45ibplooqtabcdefg --display-name example-connectionPour créer une connexion proxy à Oracle Database avec un nom utilisateur
Ouvrez une invite de commande et exécutez oci dbtools connection create-oracle-database pour créer une connexion Database Tools dans le compartiment indiqué :
oci dbtools connection create-oracle-database -c <target_compartment_ocid>
--user-name <database_user[proxy_client]> --user-password-secret-id <vault_secret_ocid>
--key-stores <keystore_json_array> --connection-string <connection_string>
--private-endpoint-id <private_endpoint_ocid> --display-name <connection_name> Remarque
Cet exemple suppose qu'une adresse privée et la clé secrète requise dans un coffre existent déjà. Cet exemple peut être utilisé sans authentification par proxy.
Cet exemple suppose qu'une adresse privée et la clé secrète requise dans un coffre existent déjà. Cet exemple peut être utilisé sans authentification par proxy.
Par exemple :
oci dbtools connection create-oracle-database -c ocid1.compartment.oc1..example1example25qrlpo4agcmothkbgqgmuz2zzum45ibplooqtabwk3zz --user-name "example-user[proxy-client]" --user-password-secret-id ocid1.vaultsecret.oc1.phx.example1secrettxiu7mwuabcdefxl67fj5niy4akfzsabcdefzf3423ya --connection-string "(description= (retry_count=20)(retry_delay=3)(address=(protocol=tcps)(port=1522)(host=adb.us-phoenix-1.oraclecloud.com))(connect_data=(service_name=example_databaseservice_low.adb.oraclecloud.com))(security=(ssl_server_cert_dn="CN=adwc.uscom-east-1.oraclecloud.com,OU=Oracle BMCS US, O=Oracle Corporation, L=Redwood City, ST=California, C=US")))" --key-stores '[{ "keyStoreContent":{ "secretId": "ocid1.vaultsecret.oc1.phx.example1ssowalletxiu7mwuabcdefxl67fj5niy4akfzsabcdefzf3423ya", "valueType": "SECRETID" }, "keyStoreType": "SSO" }]' --private-endpoint-id ocid1.databasetoolsprivateendpoint.oc1.phx.exampleendpoint25qrlpo4agcmothkbgqgmuz2zzum45ibplooqtabcdefg --display-name example-connectionProcédure de création d'une connexion proxy à Oracle Database avec des propriétés avancées
Ouvrez une invite de commande et exécutez oci dbtools connection create-oracle-database pour créer une connexion Database Tools dans le compartiment indiqué :
oci dbtools connection create-oracle-database -c <target_compartment_ocid>
--user-name <database_user> --user-password-secret-id <vault_secret_ocid> --key-stores <keystore_json_array>
--connection-string <connection_string> --private-endpoint-id <private_endpoint_ocid>
--display-name <connection_name> --advanced-properties <advanced_properties_json> Remarque
Cet exemple suppose qu'une adresse privée et la clé secrète requise dans un coffre existent déjà. Cet exemple peut être utilisé sans authentification par proxy.
Cet exemple suppose qu'une adresse privée et la clé secrète requise dans un coffre existent déjà. Cet exemple peut être utilisé sans authentification par proxy.
Par exemple :
oci dbtools connection create-oracle-database -c ocid1.compartment.oc1..example1example25qrlpo4agcmothkbgqgmuz2zzum45ibplooqtabwk3zz --user-name "example-user" --user-password-secret-id ocid1.vaultsecret.oc1.phx.example1secrettxiu7mwuabcdefxl67fj5niy4akfzsabcdefzf3423ya --connection-string "(description= retry_count=20)(retry_delay=3)(address=(protocol=tcps) (port=1522)(host=adb.us-phoenix-1.oraclecloud.com))(connect_data=(service_name=example_databaseservice_low.adb.oraclecloud.com)) (security=(ssl_server_cert_dn="CN=adwc.uscom-east-1.oraclecloud.com, OU=Oracle BMCS US, O=Oracle Corporation, L=Redwood City, ST=California, C=US")))" --key-stores '[{ "keyStoreContent":{ "secretId": "ocid1.vaultsecret.oc1.phx.example1ssowalletxiu7mwuabcdefxl67fj5niy4akfzsabcdefzf3423ya", "valueType": "SECRETID" }, "keyStoreType": "SSO" }]' --private-endpoint-id ocid1.databasetoolsprivateendpoint.oc1.phx.exampleendpoint25qrlpo4agcmothkbgqgmuz2zzum45ibplooqtabcdefg --display-name example-connection --advanced-properties '{ "oracle.jdbc.proxyClientName": "proxy-client" }'Pour créer une connexion proxy à Oracle Database à l'aide du paramètre proxy-client
Ouvrez une invite de commande et exécutez oci dbtools connection create-oracle-database pour créer une connexion Database Tools dans le compartiment indiqué :
oci dbtools connection create-oracle-database -c <target_compartment_ocid> --user-name
<database_user> --user-password-secret-id <vault_secret_ocid> --key-stores <keystore_json_array>
--connection-string <connection_string> --private-endpoint-id <private_endpoint_ocid>
--display-name <connection_name> --proxy-client <proxy_client_json> Remarque
Cet exemple suppose qu'une adresse privée et la clé secrète requise dans un coffre existent déjà. Cet exemple peut être utilisé sans authentification par proxy.
Cet exemple suppose qu'une adresse privée et la clé secrète requise dans un coffre existent déjà. Cet exemple peut être utilisé sans authentification par proxy.
Par exemple :
oci dbtools connection create-oracle-database -c ocid1.compartment.oc1..example1example25qrlpo4agcmothkbgqgmuz2zzum45ibplooqtabwk3zz --user-name "example-user" --user-password-secret-id ocid1.vaultsecret.oc1.phx.example1secrettxiu7mwuabcdefxl67fj5niy4akfzsabcdefzf3423ya --connection-string "(description=(retry_count=20)(retry_delay=3)(address=(protocol=tcps) (port=1522)(host=adb.us-phoenix-1.oraclecloud.com)) (connect_data=(service_name=example_databaseservice_low.adb.oraclecloud.com)) (security=(ssl_server_cert_dn="CN=adwc.uscom-east-1.oraclecloud.com, OU=Oracle BMCS US, O=Oracle Corporation, L=Redwood City, ST=California, C=US")))" --key-stores '[{ "keyStoreContent":{ "secretId": "ocid1.vaultsecret.oc1.phx.example1ssowalletxiu7mwuabcdefxl67fj5niy4akfzsabcdefzf3423ya", "valueType": "SECRETID" }, "keyStoreType": "SSO" }]' --private-endpoint-id ocid1.databasetoolsprivateendpoint.oc1.phx.exampleendpoint25qrlpo4agcmothkbgqgmuz2zzum45ibplooqtabcdefg --display-name example-connection --proxy-client '{ "proxy-authentication-type": "USER_NAME", "user-name": "proxy-client", "roles": [ "connect" ]}'Pour créer une connexion proxy à Oracle Database avec le paramètre proxy-client dans un fichier JSON
Ouvrez une invite de commande et exécutez oci dbtools connection create-oracle-database pour créer une connexion Database Tools comme indiqué dans le fichier JSON :
oci dbtools connection create-oracle-database --from-json "file://<path-to-json>" Remarque
Cet exemple suppose qu'une adresse privée et la clé secrète requise dans un coffre existent déjà. Cet exemple peut être utilisé sans authentification par proxy.
Cet exemple suppose qu'une adresse privée et la clé secrète requise dans un coffre existent déjà. Cet exemple peut être utilisé sans authentification par proxy.
Par exemple, en spécifiant tous les détails requis dans un fichier JSON :
{
"compartmentId": "ocid1.compartment.oc1..example1example25qrlpo4agcmothkbgqgmuz2zzum45ibplooqtabwk3zz",
"connectionString": "(description= (retry_count=20)(retry_delay=3)(address=(protocol=tcps)(port=1522)(host=adb.us-phoenix-1.oraclecloud.com))(connect_data=(service_name=example_databaseservice_low.adb.oraclecloud.com))(security=(ssl_server_cert_dn=\"CN=adwc.uscom-east-1.oraclecloud.com, OU=Oracle BMCS US, O=Oracle Corporation, L=Redwood City, ST=California, C=US\")))",
"displayName": "example-connection-from-json",
"keyStores": [
{
"keyStoreContent": {
"secretId": "ocid1.vaultsecret.oc1.phx.example1ssowalletxiu7mwuabcdefxl67fj5niy4akfzsabcdefzf3423ya",
"valueType": "SECRETID"
},
"keyStoreType": "SSO"
}
],
"userName": "example-user",
"userPasswordSecretId": "ocid1.vaultsecret.oc1.phx.example1secrettxiu7mwuabcdefxl67fj5niy4akfzsabcdefzf3423ya",
"proxyClient": {
"proxyAuthenticationType": "USER_NAME",
"userName": "proxyClient",
"userPassword": {
"valueType": "SECRETID",
"secretId": "ocid1.vaultsecret.oc1.phx.amaaaaaacsc5xjaanv6tjndg4dujfcarguywkftbvgsolw5w6fb22rhpb6ta"
},
"roles": [ "connect" ]
}
}Pour les connexions à MySQL Database
Pour créer une connexion à MySQL Database
Ouvrez une invite de commande et exécutez oci dbtools connection create-mysql-database pour créer une connexion Database Tools dans le compartiment indiqué :
oci dbtools connection create-mysql-database -c <target_compartment_ocid> --user-name <database_user> --user-password-secret-id <vault_secret_ocid> --connection-string <connection_string> --display-name <connection_name> Remarque
Cet exemple suppose que la clé secrète requise dans un coffre existe déjà.
Cet exemple suppose que la clé secrète requise dans un coffre existe déjà.
Par exemple :
oci dbtools connection create-mysql-database -c ocid1.compartment.oc1..example1example25qrlpo4agcmothkbgqgmuz2zzum45ibplooqtabwk3zz --user-name "example-user" --user-password-secret-id ocid1.vaultsecret.oc1.phx.example1secrettxiu7mwuabcdefxl67fj5niy4akfzsabcdefzf3423ya --connection-string "mysql://public-ip-or-fqdn:3306/exampledatabase" --display-name example-connectionProcédure de création d'une connexion à un système de base de données MySQL
Ouvrez une invite de commande et exécutez oci dbtools connection create-mysql-database pour créer une connexion Database Tools dans le compartiment indiqué :
oci dbtools connection create-mysql-database -c <target_compartment_ocid> --user-name <database_user> --user-password-secret-id <vault_secret_ocid> --connection-string <connection_string> --private-endpoint-id <private_endpoint_ocid> --display-name <connection_name> Remarque
Cet exemple suppose qu'une adresse privée et la clé secrète requise dans un coffre existent déjà.
Cet exemple suppose qu'une adresse privée et la clé secrète requise dans un coffre existent déjà.
Par exemple :
oci dbtools connection create-mysql-database -c ocid1.compartment.oc1..example1example25qrlpo4agcmothkbgqgmuz2zzum45ibplooqtabwk3zz --user-name "example-user" --user-password-secret-id ocid1.vaultsecret.oc1.phx.example1secrettxiu7mwuabcdefxl67fj5niy4akfzsabcdefzf3423ya --connection-string "mysql://10.0.0.42:3306/exampledatabase" --private-endpoint-id cid1.databasetoolsprivateendpoint.oc1.phx.exampleendpoint25qrlpo4agcmothkbgqgmuz2zzum45ibplooqtabcdefg --display-name example-connectionProcédure de création d'une connexion à un système de base de données MySQL via JSON
Ouvrez une invite de commande et exécutez oci dbtools connection create-mysql-database pour créer une connexion Database Tools comme indiqué dans le fichier JSON :
oci dbtools connection create-mysql-database --from-json "file://<path-to-json>" Remarque
Cet exemple suppose qu'une adresse privée et la clé secrète requise dans un coffre existent déjà.
Cet exemple suppose qu'une adresse privée et la clé secrète requise dans un coffre existent déjà.
Par exemple, en indiquant tous les détails requis dans un fichier JSON :
{
"compartmentId": "ocid1.compartment.oc1..example1example25qrlpo4agcmothkbgqgmuz2zzum45ibplooqtabwk3zz",
"userName": "example-user",
"userPasswordSecretId": "ocid1.vaultsecret.oc1.phx.example1secrettxiu7mwuabcdefxl67fj5niy4akfzsababcdefzf3423ya",
"connectionString": "mysql://10.0.0.42:3306/exampledatabase",
"privateEndpointId": "cid1.databasetoolsprivateendpoint.oc1.phx.exampleendpoint25qrlpo4agcmothkbgqgmuz2zzum45ibplooqtabcdefg",
"displayName": "example-connection-from-json"
} Remarque
Dans cet exemple, il existe un fichier JSON dans le répertoire de travail en cours nommé
Dans cet exemple, il existe un fichier JSON dans le répertoire de travail en cours nommé
example.json, comme indiqué ci-dessus.
oci dbtools connection create-mysql-database --from-json "file://example.json"