Oracle Cloud Infrastructure-Dokumentation

Befehlszeilenschnittstelle (CLI) verwenden

Erstellen Sie Datenbanktools mit der CLI.

Informationen zur Verwendung der CLI finden Sie unter Befehlszeilenschnittstelle (CLI). Eine vollständige Liste der Kennzeichen und Optionen, die für CLI-Befehle verfügbar sind, finden Sie in der Befehlszeilenreferenz.

Themen:

Für Oracle Database-Verbindungen

So erstellen Sie mit mTLS eine Verbindung zu ADB mit öffentlicher IP

Öffnen Sie eine Eingabeaufforderung, und führen Sie oci dbtools connection create-oracle-database aus, um eine neue Verbindung zu den Datenbanktools im angegebenen Compartment zu erstellen: 

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>
Hinweis

In diesem Beispiel wird davon ausgegangen, dass erforderliche Secrets bereits in einem Vault vorhanden sind.

Beispiel: Geben Sie alle erforderlichen Details als Argumente an:

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

So erstellen Sie eine Verbindung zu ADB mit öffentlicher IP mit mTLS in JSON-Datei

Öffnen Sie eine Eingabeaufforderung, und führen Sie oci dbtools connection create-oracle-database aus, um eine neue Verbindung zu den Datenbanktools zu erstellen, wie in der JSON-Datei angegeben: 

oci dbtools connection create-oracle-database --from-json "file://<path-to-json>"
Hinweis

In diesem Beispiel wird davon ausgegangen, dass erforderliche Secrets bereits in einem Vault vorhanden sind.

Beispiel: Geben Sie alle erforderlichen Details in einer JSON-Datei an:

{
  "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"
}
Hinweis

In diesem Beispiel befindet sich eine JSON-Datei im aktuellen Arbeitsverzeichnis mit dem Namen example.JSON, wie oben gezeigt. 
oci dbtools connection create-oracle-database --from-json "file://example.json"

So erstellen Sie eine Verbindung zu einem Oracle VM-DB-System mit einem privaten Endpunkt

Öffnen Sie eine Eingabeaufforderung, und führen Sie oci dbtools connection create-oracle-database aus, um eine neue Verbindung zu den Datenbanktools im angegebenen Compartment zu erstellen: 

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>
Hinweis

In diesem Beispiel wird davon ausgegangen, dass erforderliche Secrets bereits in einem Vault vorhanden sind.

Beispiel:

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-connection

So erstellen Sie eine Proxyverbindung zu Oracle Database mit dem Benutzernamen

Öffnen Sie eine Eingabeaufforderung, und führen Sie oci dbtools connection create-oracle-database aus, um eine neue Verbindung zu Datenbanktools im angegebenen Compartment zu erstellen: 

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>
Hinweis

In diesem Beispiel wird davon ausgegangen, dass ein privater Endpunkt und das erforderliche Secret in einem Vault bereits vorhanden sind. Dieses Beispiel kann ohne Proxyauthentifizierung verwendet werden.

Beispiel:

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-connection

So erstellen Sie eine Proxyverbindung zu Oracle Database mit erweiterten Eigenschaften

Öffnen Sie eine Eingabeaufforderung, und führen Sie oci dbtools connection create-oracle-database aus, um eine neue Verbindung zu Datenbanktools im angegebenen Compartment zu erstellen: 

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>
Hinweis

In diesem Beispiel wird davon ausgegangen, dass ein privater Endpunkt und das erforderliche Secret in einem Vault bereits vorhanden sind. Dieses Beispiel kann ohne Proxyauthentifizierung verwendet werden.

Beispiel:

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" }'

So erstellen Sie eine Proxyverbindung zu Oracle Database mit dem Proxy-Client-Parameter:

Öffnen Sie eine Eingabeaufforderung, und führen Sie oci dbtools connection create-oracle-database aus, um eine neue Verbindung zu Datenbanktools im angegebenen Compartment zu erstellen: 

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>
Hinweis

In diesem Beispiel wird davon ausgegangen, dass ein privater Endpunkt und das erforderliche Secret in einem Vault bereits vorhanden sind. Dieses Beispiel kann ohne Proxyauthentifizierung verwendet werden.

Beispiel:

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" ]}'

So erstellen Sie eine Proxyverbindung zu Oracle Database mit dem Proxy-Client-Parameter in der JSON-Datei

Öffnen Sie eine Eingabeaufforderung, und führen Sie oci dbtools connection create-oracle-database aus, um eine neue Verbindung zu Datenbanktools zu erstellen, wie in der JSON-Datei angegeben: 

oci dbtools connection create-oracle-database --from-json "file://<path-to-json>"
Hinweis

In diesem Beispiel wird davon ausgegangen, dass ein privater Endpunkt und das erforderliche Secret in einem Vault bereits vorhanden sind. Dieses Beispiel kann ohne Proxyauthentifizierung verwendet werden.

Beispiel: Geben Sie alle erforderlichen Details in einer JSON-Datei an:

{
  "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" ]
  }
}

Für MySQL Database-Verbindungen

So erstellen Sie eine Verbindung zu einer MySQL Database

Öffnen Sie eine Eingabeaufforderung, und führen Sie oci dbtools connection create-mysql-database aus, um eine neue Verbindung zu den Datenbanktools im angegebenen Compartment zu erstellen: 

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>
Hinweis

In diesem Beispiel wird davon ausgegangen, dass das erforderliche Secret in einem Vault bereits vorhanden ist.

Beispiel:

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-connection

So erstellen Sie eine Verbindung zu einem MySQL-DB-System

Öffnen Sie eine Eingabeaufforderung, und führen Sie oci dbtools connection create-mysql-database aus, um eine neue Verbindung zu den Datenbanktools im angegebenen Compartment zu erstellen: 

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>
Hinweis

In diesem Beispiel wird davon ausgegangen, dass ein privater Endpunkt und das erforderliche Secret in einem Vault bereits vorhanden sind.

Beispiel:

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-connection

So erstellen Sie eine Verbindung zu einem MySQL-DB-System über JSON

Öffnen Sie eine Eingabeaufforderung, und führen Sie oci dbtools connection create-mysql-database aus, um eine neue Verbindung zu den Datenbanktools zu erstellen, wie in der JSON-Datei angegeben: 

oci dbtools connection create-mysql-database --from-json "file://<path-to-json>"
Hinweis

In diesem Beispiel wird davon ausgegangen, dass ein privater Endpunkt und das erforderliche Secret in einem Vault bereits vorhanden sind.

Beispiel: Geben Sie alle erforderlichen Details in einer JSON-Datei an:

{  
    "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"
}
Hinweis

In diesem Beispiel befindet sich eine JSON-Datei im aktuellen Arbeitsverzeichnis mit dem Namen example.JSON, wie oben gezeigt. 
oci dbtools connection create-mysql-database --from-json "file://example.json"