8.3.2.2 Step 1: Create a JSON file with the Connect Descriptor

Create a Centralized Configuration Provider JSON file with the connect descriptor and upload it to the Oracle Cloud Infrastructure (OCI) Object Storage.

  1. Create a JSON file in one of the following formats:
    • Single object specified with a connect_descriptor sub-object:

      The following example shows a sample sales.json file, configured with a connect descriptor for the sales.myexample.com service:
      { 
       "connect_descriptor": "(DESCRIPTION=
                                 (ADDRESS=
                                    (PROTOCOL=TCP)
                                    (HOST=my sales dbserver)
                                    (PORT=1521))
                                 (CONNECT_DATA=
                                    (SERVER=DEDICATED)
                                    (SERVICE_NAME=sales.myexample.com))
                              )" 
      }
    • Multiple objects (separated by a comma), and each object with a separate connect_descriptor sub-object:

      The following example shows a sample multi.json file, configured with multiple connect descriptors for the sales and hr objects.
      { 
       "sales" : { 
          "connect_descriptor": "(DESCRIPTION=
                                    (ADDRESS=
                                       (PROTOCOL=TCP)
                                       (HOST=my sales dbserver)
                                       (PORT=1521))
                                    (CONNECT_DATA=
                                       (SERVER=DEDICATED)
                                       (SERVICE_NAME=sales.myexample.com))
                                 )"
       },
       "hr" : { 
          "connect_descriptor": "(DESCRIPTION=
                                    (ADDRESS=
                                       (PROTOCOL=TCP)
                                       (HOST=my dbserver.my.example.com)
                                       (PORT=1521))
                                    (CONNECT_DATA=
                                       (SERVER=DEDICATED)
                                       (SERVICE_NAME=hr.my.example.com))
                                 )" 
       } 
      }

    Note:

    There are some restrictions on the parameter names and values that can appear in connect descriptors. Ensure that you specify only the allowed parameters and values, as listed in Oracle AI Database Net Services Reference.
  2. Store your JSON file in the OCI Object Storage:

    In the OCI console, navigate to the Object Storage - Bucket Details page of your bucket and upload the file to that bucket under Objects.