setCosConn stored procedure
Defines a cloud object storage connection in Data Virtualization. The schema is DVSYS.
Input parameters
- object_store_type
- The type of this required parameter is VARCHAR(20). Object storage types that are currently supported by Data Virtualization include 'AWS3', 'IBMCOS', and 'CEPH'.
- endpoint_URL
- The type of this required parameter is VARCHAR(32672). Specifies the endpoint URL of the object storage. For example, 's3.eu-central-1.amazonaws.com'.
- bucket
- The type of this optional parameter is VARCHAR(32672). Specifies a bucket name for the endpoint. If this parameter is omitted, it indicates a global connection. You can specify one global connection per Data Virtualization instance.
- access_key
- The type of this required parameter is VARCHAR(32672). Specifies the access key for the object storage.
- secret_key
- The type of this required parameter is VARCHAR(32672). Specifies the secret key for the object storage.
- SSL_certificate
- The type of this optional parameter is VARCHAR(32672). This parameter is not supported.
- additional_properties_for_common_connectivity
- The type of this optional parameter is VARCHAR(32672).
- additional_options
- The type of this optional parameter is VARCHAR(32672). Specifies a comma-delimited list of extra
parameters in the following format:
'<key1>=<value1>, <key2>=<value2>, ...'
. Supported options include EDITCID (change properties for a given CID) and CCID (provide a common connectivity ID).
Output parameters
- connection_ID
- The type of this parameter is VARCHAR(20). Represents the generated connection ID for Data Virtualization.
- diagnostics
- The type of this parameter is VARCHAR(32672). Represents diagnostic output if a failure occurs.
Example
call DVSYS.setcosconn('AWS3', 's3.eu-central-1.amazonaws.com', 'myNewBucket', '<ACCESS_KEY>', '<SECRET_KEY>', null, null, null, ?, ?)
The output might look like the following
text.
Value of output parameters
--------------------------
Parameter Name : CONNECTIONID
Parameter Value : AWS310001
Parameter Name : DIAGS
Parameter Value : -
Return Status = 0