Connecting to Data Sources

In Oracle Cloud Infrastructure Data Integration, data assets represent data sources that you can use as sources and targets for your integration tasks. Data assets can be databases, flat files, and so on.

You create and access data assets from the Data Assets page. From the workspace home page, you can access the Data Assets page by clicking Data Assets or by clicking the Open tab (plus icon) in the tab bar and then selecting Data Assets.

The Data Assets page lists all the data assets you have created in the workspace. You can do a full text search by entering the data asset name in the Filter by name search field. You can also use the Favorite Filter menu to display only those data assets that are currently marked as favorite or those that are currently not marked as favorite. Clicking Clear removes the filter.

On the Data Assets list, the Actions menu for a data asset has these options:

  • View Details: Displays the data asset details, including connections and schemas.
  • Edit: Lets you edit the data asset, including adding and editing connections.
  • Test Connection: Lets you test the default connection for the data asset.
  • Copy Data Asset Key: Copies to the clipboard the key of the data asset, which you can use with APIs.
  • Delete: Lets you delete the data asset.

For information about the types of data sources you can use, see Supported Data Sources for Data Assets.

When you create a data asset, you specify one default connection to that data source. A connection is a user and password combination that is used to connect to the data source. For most data source types, you can use secrets in Oracle Cloud Infrastructure Vault to store the password that you need to connect to the source using the default connection. By using OCI Vault, you provide the OCID of the secret when specifying the connection details, so you don't have to enter the actual password when you create the data asset. For sources with Oracle wallets, you can also use OCI Vault secrets for the wallet and passwords. See OCI Vault Secrets and Oracle Wallets.

After you create your data asset, you're brought to the details page where you can review or update the data asset name, description, and tags. You can see the connections, schemas, and data entities. For more information, see Viewing Data Asset Details.

You can create additional connections for a data asset as needed. Each connection should give you access to additional schemas and data entities  to integrate. For more information on connections, see Creating a Connection.

OCI Vault Secrets and Oracle Wallets

Oracle Cloud Infrastructure Data Integration is integrated with Oracle Cloud Infrastructure Vault to enable you to manage sensitive information using vaults, keys, and secrets.

A vault is a container for keys and secrets. Secrets store credentials such as required passwords for connecting to data sources. You use an encryption key in a vault to encrypt and import secret contents to the vault. Secret contents are based64-encoded. Oracle Cloud Infrastructure Data Integration uses the same key to retrieve and decrypt secrets when creating a data asset and connecting to the data source.

For most data source types, you can use a secret in OCI Vault to store the password for the default connection in a data asset. To create a vault, key, and secret, see Overview of Vault.

When you create a data asset, you provide the OCID of the secret in the connection details, so you don't have to enter the actual password. To copy the secret OCID, see View Secret Details.

For Oracle Database, Oracle Autonomous Data Warehouse, and Oracle Autonomous Transaction Processing sources, you have the option to use secrets for the Oracle wallet and passwords instead of uploading the wallet and entering the wallet password when you create your data asset.

To use an Oracle wallet with secrets in OCI Vault, you must:

  1. Provide a wallet password when you download the wallet.
  2. Remove the .p12 file from the dowloaded wallet zip.
  3. Use any base64 encoder to encode the modified wallet zip to base64.
  4. Copy the base64-encoded data to a secret in a vault.
  5. Create a secret for the wallet password.
  6. Create a secret for the database password.

To use secrets in OCI Vault, ensure that you have the following policy:

allow any-user to read secret-bundles in compartment <compartment-name> where ALL {request.principal.type = 'disworkspace', request.principal.id = '<workspace-ocid>'}

The following policy enables a group of users who are not administrators to use secrets with Oracle Autonomous Data Warehouse and Oracle Autonomous Transaction Processing:

allow group <group-name> to read secret-bundles in compartment <compartment-name>

Supported Data Sources for Data Assets

The following table lists the data sources that you can use with Data Integration.

Data Source Type Version Source Target
Amazon RDS for SQL Server 2019 Yes No
2017 Yes No
2016 Service Pack 2 Yes No
2014 Service Pack 3 Yes No
2012 Service Pack 4 Yes No
Amazon Redshift Amazon Redshift Yes No
Apache Hive CDH 5.4 and higher Yes No
Apache 1.0, 2.0, 3.0 and higher Yes No
Azure SQL Database 11.0 and higher Yes No
12.0 and higher Yes No
Microsoft SQL Server 2019 Yes No
2017 Yes No
2016 Service Pack 2 Yes No
2014 Service Pack 3 Yes No
2012 Service Pack 4 Yes No
MySQL 5.7.x and 8.0.x Yes Yes
MySQL on Amazon RDS 5.7.x and 8.0.x Yes No
Amazon S3 Amazon S3 Yes No
Autonomous Data Warehouse 18c/19c Yes Yes
Autonomous Transaction Processing 18c/19c Yes Yes
Oracle Database 12.1 Yes Yes
12.2 Yes Yes
18 Yes Yes
19 Yes Yes
21 Yes Yes
Oracle Database on Oracle Cloud Infrastructure 12.1 Yes Yes
12.2 Yes Yes
18 Yes Yes
19 Yes Yes
Exadata DB Systems 12.1 Yes Yes
12.2 Yes Yes
18 Yes Yes
19 Yes Yes
Oracle Object Storage Latest Yes Yes
Oracle on Amazon RDS 12.1 Yes No
12.2 Yes No
18 Yes No
19 Yes No
21 Yes No
Oracle Fusion Applications using Oracle Business Intelligence Cloud Connector (BICC)

BICC API version 13.20.10 and higher

Fusion Applications version 13.20.10 (20 Oct) and higher

YesNo
PostgreSQL 12.0 and higher Yes No
11.0 and higher Yes No
10.1 Yes No
9.6, 9.5, 9.4, 9.3, 9.2, 9.1, and 9.0 Yes No
8.4, 8.3, and 8.2 Yes No

Supported Object Types

For Oracle Object Storage and Amazon S3 data assets, Data Integration supports the following object types:

  • CSV
  • JSON
  • Parquet
  • Avro

Note that only read and write of primitive data types are supported.

Supported Compression Types

For Oracle Object Storage data assets, Data Integration supports the following compression types or methods for using the CSV or JSON object file type with a source or target operator:

  • Auto (Default)
  • Gzip
  • Bzip2
  • Deflate
  • Lz4
  • Snappy

For Parquet and Avro file types, only Auto (Default) is supported.

If a source file is compressed, the compression type is actually the compression algorithm that is used. If you do not know the compression algorithm, then use the Auto (Default) compression type.

Data Types Not Supported

The following Oracle Database data types are not supported:

  • ROWID
  • UROWID
  • BFILE
  • TIMESTAMP WITH LOCAL TIMEZONE
  • INTERVAL DAY TO SECOND
  • INTERVAL YEAR TO MONTH
  • XMLTYPE
  • SDO_GEOMETRY

Network Configurations

Your network configurations depend on the source and target data assets you're using with the Data Integration service, and where the assets are located.

See this blog to identify the options for your needs.

A workspace can have an attached Virtual Cloud Network (VCN). In general, for data sources that are accessible from the internet:

  • If a workspace has an attached VCN: Data Integration can connect directly through a Network Address Translation (NAT) gateway on the VCN of the workspace.
  • If a workspace does not have an attached VCN: Data Integration can connect directly using public IP addresses.

Resources, such as workspaces, with private IPs defined in any subnet can access other private resources in different virtual cloud networks and regions through Service gateways or NAT gateways using local or remote peering gateways.

You can also combine gateways when you need to access both Object Storage and Autonomous Data Warehouse. For example, for public connectivity, you would need both a Service gateway for Object Storage and a NAT gateway for Autonomous Data Warehouse.

For data sources that are not accessible from the internet, other options include:

  • Create a workspace with a private endpoint enabled, with the private endpoint in the same subnet as the data source.

  • Use Oracle Cloud Infrastructure FastConnect.

  • Use Oracle Cloud Infrastructure VPN Connect (also referred to as an IPSec VPN).

Note, however, that Oracle Cloud Infrastructure FastConnect and Oracle Cloud Infrastructure VPN Connect must be used when these sources are in private domains:

  • Oracle on Amazon RDS
  • MySQL on Amazon RDS
  • Amazon RDS for SQL Server
  • Microsoft Azure SQL Database

Creating a Data Asset

When you create a data asset, you select the data source type and then provide the data source details and the corresponding default connection details to that source. You can use the Console or the APIs to create data assets.

For most data assets, instead of providing the actual password for a connection, you can choose to use a secret in Oracle Cloud Infrastructure Vault that has the password for the connection user. Take note of the following before using OCI Vault secrets:

  • Ensure that you have set up the required policies for using OCI vault and secrets.
  • Create a secret for the database password.
  • If you use Oracle wallets, you must modify the wallet zip before you create a secret for the wallet contents. You also need a secret for the wallet password, and a secret for the database password.

See OCI Vault Secrets and Oracle Wallets.

If you intend to publish a task to an application in OCI Data Flow, note also the following when creating your data assets:

  • Use OCI Vault secrets that contain the passwords to connect to the data sources. This is required for passing credentials securely across OCI services.
  • Specify the Fully Qualified Domain Name (FQDN) for the database hosts. OCI Data Flow does not allow connections through host IP addresses.

Each type of data asset has a different set of source and connection fields. Use the appropriate instructions for the data asset type you want to create.

OCI Data Sources

Creating an Oracle Object Storage Data Asset
Important

Before you can create a Service-to-Service (S2S) Principal connection for your Oracle Object Storage data asset, you must create a policy to allow Data Integration to access the Oracle Object Storage resource. See creating a policy and Policy Examples to Enable Access to Oracle Object Storage under Policy Examples.
  1. On the workspace's Home page, select Create Data Asset from the Quick Actions tile.

    You can also click Create Data Asset on the Data Assets page.

  2. On the Create Data Asset page, enter a name and description (optional).
  3. From the Type drop-down, select Oracle Object Storage.
  4. For URL, enter the URL for your Oracle Object Storage resource in the following format:

    https://objectstorage.<region-identifier>.oraclecloud.com

    For example: https://objectstorage.us-phoenix-1.oraclecloud.com

    Important

    The Object Storage data source that you set up as a source or target data asset in Data Integration is identified using its region ID, namespace, and bucket name. You won't encounter any issues if the source and target data assets have different region IDs, different namespaces, and different bucket names. If the source and target have the same bucket name but different region IDs and namespaces, or if they have the same namespace but different region IDs and different bucket names, then also you won't encounter any issues. However, if only the source and target data asset region IDs are different and the namespace and bucket names are the same, your tasks in Data Integration will fail.
  5. For Tenant OCID, enter the Oracle Cloud ID of the tenancy.
    Note

    To view your tenancy OCID string in the Console, from the Profile menu click Tenancy:<your_tenancy_name>. You can find the tenancy OCID under Tenancy Information.

  6. For Namespace, enter the namespace for the Object Storage bucket, if the value is not auto-populated after completing the preceding step.
  7. Under Default Connection Information, enter a name and description (optional).
  8. (Optional) After you complete all the required fields, you can click Test Connection to ensure you've entered the data asset details correctly.

    A success or failure message displays, indicating whether the test was successful or not. If the test fails, review your connection settings and try again.

  9. Click Create.
Creating an Oracle Database Data Asset
  1. On the workspace's Home page, select Create Data Asset from the Quick Actions tile.

    You can also click Create Data Asset on the Data Assets page.

  2. On the Create Data Asset page, enter a name and description (optional).
  3. From the Type drop-down, select Oracle Database.
  4. Select a connection type (Basic or Wallet), depending on whether you want to provide an Oracle Wallet file.
  5. Enter the Host name and Port of the data asset.
  6. For Database, select Service Name or SID, and then provide the TNS alias to connect to your database remotely or enter the unique name that identifies your database instance.
  7. If you selected Wallet for the connection type, do the following:
    1. Select Upload Wallet or Use Vault Secret OCID, depending on whether you want to upload the wallet or use secrets in Oracle Cloud Infrastructure Vault to retrieve the wallet and wallet password.
    2. For Upload Wallet: Drag the wallet file to the Drop File space or click Select File to browse and then select the wallet to upload. Then enter the Wallet Password.
    3. For Use Vault Secret OCID: Enter the OCID of the secret for the wallet, and then enter the OCID of the secret for the wallet password.
  8. Under Default Connection Information, provide the credentials for the default connection to the data asset:
    1. Enter a name and a description (optional).
    2. If you selected Upload Wallet, enter the User Name and Password.
    3. If you selected Use Vault Secret OCID, enter the User Name and then the OCID of the secret for the database password associated with the user.
  9. (Optional) After you complete all the required fields, you can click Test Connection to ensure you've entered the data asset details correctly.

    A success or failure message displays, indicating whether the test was successful or not. If the test fails, review your connection settings and try again.

  10. Click Create.
Creating an Autonomous Data Warehouse or Autonomous Transaction Processing Data Asset
To use Autonomous Data Warehouse or Autonomous Transaction Processing as your source or target data asset, your database administrator must grant the following privileges to the Autonomous Data Warehouse or Autonomous Transaction Processing user in Data Integration. For example:
GRANT EXECUTE ON DBMS_CLOUD TO <USER_NAME>
GRANT DWROLE TO <USER_NAME>
  1. On the workspace's Home page, select Create Data Asset from the Quick Actions tile.

    You can also click Create Data Asset on the Data Assets page.

  2. On the Create Data Asset page, enter a name and description (optional).
  3. From the Type drop-down, select Oracle Autonomous Data Warehouse or Oracle Autonomous Transaction Processing.
  4. Select how you want to provide the login credentials for the autonomous database depending on whether you want to upload the wallet, automatically retrieve the wallet, or use secrets in Oracle Cloud Infrastructure Vault to retrieve the wallet and wallet password.
    • Upload Wallet: Drag the wallet file to the Drop File space or click Select File to browse and then select the wallet to upload. Optionally, enter the Wallet Password.
    • Select Database: Select the Region, Tenant OCID, Compartment, and Autonomous Database. Optionally, enter the Wallet Password.
      Note

      You must have the required permissions to connect to the autonomous database and download the client credentials file.
    • Use Vault Secret OCID: Enter the OCID of the secret for the wallet, and then enter the OCID of the secret for the wallet password.
  5. For Service Name select the Autonomous Data Warehouse or Autonomous Transaction Processing database.
  6. Under Default Connection Information, provide the credentials for the default connection to the data asset:
    1. Enter a name and a description (optional).
    2. If you selected Upload Wallet or Select Database, enter the User Name and Password.
    3. If you selected Use Vault Secret OCID, enter the User Name and then the OCID of the secret for the database password associated with the user.
  7. (Optional) After you complete all the required fields, click Test Connection to ensure you've entered the data asset details correctly.

    A success or failure message displays, indicating whether the test was successful or not. If the test fails, review your connection settings and try again.

  8. Click Create.
Note

When you use Autonomous Data Warehouse or Autonomous Transaction Processing as the target in a data flow design, you select an Object Storage bucket as the staging location. Ensure that you enable the PAR_MANAGE permission on the staging bucket. In addition, you must create all the required Object Storage policies.

Learn more about pre-authenticated requests.

When you use Autonomous Data Warehouse as a target data asset, you need the following policy:
allow any-user to manage buckets in compartment <compartment-name> where ALL {request.principal.type = 'disworkspace', request.principal.id = '<workspace-ocid>', request.permission = 'PAR_MANAGE'}
Creating an Oracle Fusion Applications Data Asset

Using Oracle Fusion Applications data assets in Data Integration requires additional setups and access to other services in Oracle Cloud Infrastructure.

Before you create an Oracle Fusion Applications data asset, ensure that you understand the dependencies, and have completed the prerequisite tasks.

Before You Begin

Data Integration uses the Oracle Business Intelligence Cloud Connector (BICC) to enable connections to Oracle Fusion Applications as data sources.

You use an Oracle Fusion Applications data asset as a source to extract data from Oracle Fusion Applications such as an ERP or HCM application. Data Integration loads the extracted data into a predefined external storage location that is configured in BICC. Policies to use BICC and network requirements for accessing Oracle Fusion Applications must be in place.

Use the following task checklist to ensure that you have the required setup and information you need for creating and using Oracle Fusion Applications data sources.

TaskRequirement
Obtain access to BICC

This topic assumes you already have the proper user credentials to access and use BICC.

See Provision Access in Creating a Business Intelligence Cloud Extract.

You use BICC to set up an external storage location for staging the extracted data.

Obtain your Fusion Applications connection details

When you create a Fusion Applications data asset, you need to provide the following:

  • Host name of the inbound server
  • User name and password to connect to the server

Instead of providing the actual the password, you can use a secret in Oracle Cloud Infrastructure Vault to store the password, and provide the OCID of that secret.

See Overview of Vault.

To copy the secret OCID, see View Secret Details.

Verify network configuration to access Oracle Fusion Applications.

If the Fusion Applications host is accessible from the Internet, and the workspace has an attached virtual cloud network (VCN), the VCN must:

  • Use DNS hostnames
  • Include an Internet gateway

See Virtual Networking Quickstart.

If the Fusion Applications host is not accessible from the Internet, you can use Oracle Cloud Infrastructure FastConnect to set up a fast and secure connection between Oracle Cloud Infrastructure and the Fusion Applications host.

Create policies to allow Data Integration to access buckets and objects in Oracle Object Storage.

The policies are required for staging the extracted data, which need pre-authentication to complete the operations.

allow group <group-name> to use object-family in compartment <compartment-name>

allow any-user to use buckets in compartment <compartment-name> where ALL {request.principal.type = 'disworkspace', request.principal.id = '<workspace-ocid>'}

allow any-user to manage objects in compartment <compartment-name> where ALL {request.principal.type = 'disworkspace', request.principal.id = '<workspace-ocid>'}

allow any-user to manage buckets in compartment <compartment-name> where ALL {request.principal.type = 'disworkspace', request.principal.id = '<workspace-ocid>', request.permission = 'PAR_MANAGE'}

Create a bucket in Oracle Object Storage.

Object Storage is the only storage type in BICC that you can use as the external storage location for staging extracted data.

After creating a bucket, gather the following details, which you need to provide when you set up the External Storage Location in BICC.

  • Object Storage host URL. For example: https://objectstorage.us-ashburn-1.oraclecloud.com
  • OCID of the tenancy where you created the bucket
  • Namespace of the tenancy
  • OCID of the user with access to the bucket
  • Bucket name
Set up the external storage location in BICC to reference the Object Storage bucket you created.

See Storage Type - OCI Object Storage Connection under Configure Where to Load Data in Creating a Business Intelligence Cloud Extract.

Note

Policies required also depend on whether the Object Storage instance and Data Integration instance are in the same tenancy or different tenancies, and whether you create the policies at the compartment level or tenancy level. Review more examples and this blog to identify the right policies for your needs.
Creating an Oracle Fusion Applications Data Asset
  1. On the workspace's Home page, select Create Data Asset from the Quick Actions tile.

    You can also click Create Data Asset on the Data Assets page.

  2. On the Create Data Asset page, enter a name and description (optional).
  3. From the Type menu, select Oracle Fusion Applications.
  4. Enter the Oracle Fusion Applications Host name.
  5. Enter database parameters in the Data Asset Properties field, if needed.
  6. Under Default Connection Information, provide the credentials for the default connection to the data asset:
    1. Enter a name and a description (optional).
    2. Enter the User Name that can connect to the Fusion Applications host.
    3. Select Use Password or Use Vault Secret OCID, depending on whether you use a secret in Oracle Cloud Infrastructure Vault to store the password for the user. Then enter the password or the OCID of the secret for the password.
  7. From the Default BICC External Storage Configuration menu, select the default external storage location to use for this data asset.

    You can override the default location when you add the Fusion Applications data asset to your data flow.

  8. (Optional) After you complete all the required fields, you can click Test Connection to ensure you have entered the data asset details correctly.

    A success or failure message displays, indicating whether the test was successful or not. If the test fails, review your connection settings and try again.

  9. Click Create.

Third-party Sources on Cloud or On-premise

Creating an Apache Hive Data Asset
  1. On the workspace's Home page, select Create Data Asset from the Quick Actions tile.

    You can also click Create Data Asset on the Data Assets page.

  2. On the Create Data Asset page, enter a name and description (optional).
  3. From the Type drop-down, select Apache Hive.
  4. Enter the Host name and Port, and then enter additional database parameters in the Data Asset Properties field, if needed.
  5. Under Default Connection Information, provide the credentials for the default connection to the data asset:
    1. Enter a name and a description (optional).
    2. In Connection Properties, enter additional connection parameters, if needed.
    3. Enter the User Name.
    4. Select Use Password or Use Vault Secret OCID, depending on whether you use a secret in Oracle Cloud Infrastructure Vault to store the password. Then enter the password or the OCID of the secret for the password.
  6. (Optional) After you complete all the required fields, you can click Test Connection to ensure you've entered the data asset details correctly.

    A success or failure message displays, indicating whether the test was successful or not. If the test fails, review your connection settings and try again.

  7. Click Create.
Creating a MySQL Data Asset
  1. On the workspace's Home page, select Create Data Asset from the Quick Actions tile.

    You can also click Create Data Asset on the Data Assets page.

  2. On the Create Data Asset page, enter a name and description (optional).
  3. From the Type drop-down, select MySQL.
  4. Enter the Host name and Port, and then enter the Database name.
  5. Under Default Connection Information, provide the credentials for the default connection to the data asset:
    1. Enter a name and a description (optional).
    2. In Connection Properties, enter additional connection parameters, if needed.
    3. Enter the User Name.
    4. Select Use Password or Use Vault Secret OCID, depending on whether you use a secret in Oracle Cloud Infrastructure Vault to store the password. Then enter the password or the OCID of the secret for the password.
  6. (Optional) After you complete all the required fields, you can click Test Connection to ensure you've entered the data asset details correctly.

    A success or failure message displays, indicating whether the test was successful or not. If the test fails, review your connection settings and try again.

  7. Click Create.
Creating a PostgreSQL Data Asset
  1. On the workspace's Home page, select Create Data Asset from the Quick Actions tile.

    You can also click Create Data Asset on the Data Assets page.

  2. On the Create Data Asset page, enter a name and description (optional).
  3. From the Type drop-down, select PostgreSQL.
  4. Enter the Host name and Port, and then enter additional database parameters in the Data Asset Properties field, if needed.
  5. Under Default Connection Information, provide the credentials for the default connection to the data asset:
    1. Enter a name and a description (optional).
    2. In Connection Properties, enter additional connection parameters, if needed.
    3. Enter the User Name.
    4. Select Use Password or Use Vault Secret OCID, depending on whether you use a secret in Oracle Cloud Infrastructure Vault to store the password. Then enter the password or the OCID of the secret for the password.
  6. (Optional) After you complete all the required fields, you can click Test Connection to ensure you've entered the data asset details correctly.

    A success or failure message displays, indicating whether the test was successful or not. If the test fails, review your connection settings and try again.

  7. Click Create.
Creating a Microsoft SQL Server Data Asset
  1. On the workspace's Home page, select Create Data Asset from the Quick Actions tile.

    You can also click Create Data Asset on the Data Assets page.

  2. On the Create Data Asset page, enter a name and description (optional).
  3. From the Type drop-down, select Microsoft SQL Server.
  4. Enter the Host name and Port, and then enter additional database parameters in the Data Asset Properties field, if needed.
  5. Under Default Connection Information, provide the credentials for the default connection to the data asset:
    1. Enter a name and a description (optional).
    2. In Connection Properties, enter additional connection parameters, if needed.
    3. Enter the User Name.
    4. Select Use Password or Use Vault Secret OCID, depending on whether you use a secret in Oracle Cloud Infrastructure Vault to store the password. Then enter the password or the OCID of the secret for the password.
  6. (Optional) After you complete all the required fields, you can click Test Connection to ensure you've entered the data asset details correctly.

    A success or failure message displays, indicating whether the test was successful or not. If the test fails, review your connection settings and try again.

  7. Click Create.

Data Sources on Third-party Platform

Creating an Amazon RDS for SQL Server Data Asset
  1. On the workspace's Home page, select Create Data Asset from the Quick Actions tile.

    You can also click Create Data Asset on the Data Assets page.

  2. On the Create Data Asset page, enter a name and description (optional).
  3. From the Type drop-down, select Amazon RDS for SQL Server.
  4. Enter the Host name and Port, and then enter additional database parameters in the Data Asset Properties field, if needed.
  5. Under Default Connection Information, provide the credentials for the default connection to the data asset:
    1. Enter a name and a description (optional).
    2. In Connection Properties, enter additional connection parameters, if needed.
    3. Enter the User Name.
    4. Select Use Password or Use Vault Secret OCID, depending on whether you use a secret in Oracle Cloud Infrastructure Vault to store the password. Then enter the password or the OCID of the secret for the password.
  6. (Optional) After you complete all the required fields, you can click Test Connection to ensure you've entered the data asset details correctly.

    A success or failure message displays, indicating whether the test was successful or not. If the test fails, review your connection settings and try again.

  7. Click Create.
Creating an Amazon Redshift Data Asset
  1. On the workspace's Home page, select Create Data Asset from the Quick Actions tile.

    You can also click Create Data Asset on the Data Assets page.

  2. On the Create Data Asset page, enter a name and description (optional).
  3. From the Type drop-down, select Amazon Redshift.
  4. Enter the Host name and Port, and then enter additional database parameters in the Data Asset Properties field, if needed.
  5. Under Default Connection Information, provide the credentials for the default connection to the data asset:
    1. Enter a name and a description (optional).
    2. In Connection Properties, enter additional connection parameters, if needed.
    3. Enter the User Name.
    4. Select Use Password or Use Vault Secret OCID, depending on whether you use a secret in Oracle Cloud Infrastructure Vault to store the password. Then enter the password or the OCID of the secret for the password.
  6. (Optional) After you complete all the required fields, you can click Test Connection to ensure you've entered the data asset details correctly.

    A success or failure message displays, indicating whether the test was successful or not. If the test fails, review your connection settings and try again.

  7. Click Create.
Creating an Amazon S3 Data Asset

Amazon S3 (Simple Storage Service) is storage service that lets you store semi-structured and unstructured data as objects within resources called buckets. You only need to create one data asset in Data Integration for all the buckets your AWS credentials has access to.

  1. On the workspace's Home page, select Create Data Asset from the Quick Actions tile.

    You can also click Create Data Asset on the Data Assets page.

  2. On the Create Data Asset page, enter a name and description (optional).
  3. From the Type drop-down, select Amazon S3.
  4. Select an AWS Region, and then enter additional database parameters in the Data Asset Properties field, if needed.
  5. Under Default Connection Information, provide the credentials for the default connection to the data asset:
    1. Enter a name and a description (optional).
    2. Select Manual or Use Vault Secret OCID, depending on whether you use a secret in Oracle Cloud Infrastructure Vault to store the Amazon S3 database credentials. Then enter the Access Key and Secret Key or the OCID of the secrets for the credentials.
  6. (Optional) After you complete all the required fields, you can click Test Connection to ensure you've entered the data asset details correctly.

    A success or failure message displays, indicating whether the test was successful or not. If the test fails, review your connection settings and try again.

  7. Click Create.
Creating a Microsoft Azure SQL Database Data Asset
  1. On the workspace's Home page, select Create Data Asset from the Quick Actions tile.

    You can also click Create Data Asset on the Data Assets page.

  2. On the Create Data Asset page, enter a name and description (optional).
  3. From the Type drop-down, select Microsoft Azure SQL Database.
  4. Enter the Host name and Port, and then enter additional database parameters in the Data Asset Properties field, if needed.
  5. Under Default Connection Information, provide the credentials for the default connection to the data asset:
    1. Enter a name and a description (optional).
    2. In Connection Properties, enter additional connection parameters, if needed.
    3. Enter the User Name.
    4. Select Use Password or Use Vault Secret OCID, depending on whether you use a secret in Oracle Cloud Infrastructure Vault to store the password. Then enter the password or the OCID of the secret for the password.
  6. (Optional) After you complete all the required fields, you can click Test Connection to ensure you've entered the data asset details correctly.

    A success or failure message displays, indicating whether the test was successful or not. If the test fails, review your connection settings and try again.

  7. Click Create.
Creating a MySQL on Amazon RDS Data Asset
  1. On the workspace's Home page, select Create Data Asset from the Quick Actions tile.

    You can also click Create Data Asset on the Data Assets page.

  2. On the Create Data Asset page, enter a name and description (optional).
  3. From the Type drop-down, select MySQL on Amazon RDS.
  4. Enter the Host name and Port, and then enter the Database name.
  5. Under Default Connection Information, provide the credentials for the default connection to the data asset:
    1. Enter a name and a description (optional).
    2. In Connection Properties, enter additional connection parameters, if needed.
    3. Enter the User Name and Password.
  6. (Optional) After you complete all the required fields, you can click Test Connection to ensure you've entered the data asset details correctly.

    A success or failure message displays, indicating whether the test was successful or not. If the test fails, review your connection settings and try again.

  7. Click Create.
Creating an Oracle Database on Amazon RDS Data Asset
  1. On the workspace's Home page, select Create Data Asset from the Quick Actions tile.

    You can also click Create Data Asset on the Data Assets page.

  2. On the Create Data Asset page, enter a name and description (optional).
  3. From the Type drop-down, select Oracle on Amazon RDS.
  4. Select a connection type (Basic or Wallet), depending on whether you want to provide an Oracle Wallet file.
  5. Enter the Host name and Port of the data asset.
  6. For Database, select Service Name or SID, and then provide the TNS alias to connect to your database remotely or enter the unique name that identifies your database instance.
  7. If you selected Wallet for the connection type, do the following:
    1. Select Upload Wallet or Use Vault Secret OCID, depending on whether you want to upload the wallet or use secrets in Oracle Cloud Infrastructure Vault to retrieve the wallet and wallet password.
    2. For Upload Wallet: Drag the wallet file to the Drop File space or click Select File to browse and then select the wallet to upload. Then enter the Wallet Password.
    3. For Use Vault Secret OCID: Enter the OCID of the secret for the wallet, and then enter the OCID of the secret for the wallet password.
  8. Under Default Connection Information, provide the credentials for the default connection to the data asset:
    1. Enter a name and a description (optional).
    2. If you selected Upload Wallet, enter the User Name and Password.
    3. If you selected Use Vault Secret OCID, enter the User Name and then the OCID of the secret for the database password associated with the user.
  9. (Optional) After you complete all the required fields, you can click Test Connection to ensure you've entered the data asset details correctly.

    A success or failure message displays, indicating whether the test was successful or not. If the test fails, review your connection settings and try again.

  10. Click Create.

Creating a Connection

When you create a data asset, you must provide the default connection details. For existing data assets, you can add additional connections as needed.

To create a connection on an existing data asset:

  1. In the tab bar, click Open tab (plus icon) and then select Data Assets.
  2. On the Data Assets page, select the data asset for which you want to add a connection.
  3. On the data asset details page, click Add Connection.

    Only one connection is needed for an Oracle Object Storage data asset; you cannot create more than one.

  4. In the Add Connection panel, complete the fields as needed to create a connection.

    Select the check box Make this the default connection if this connection is the default for this data asset.

  5. (Optional) After you complete all the required fields, you can click Test Connection to ensure that a connection can be established.

    A success or failure message displays, indicating whether the test is successful or not. A successful test is not required to add the connection.

  6. Click Save Connection.

Viewing Data Asset Details

The Data Assets page shows you a list of all the data assets in your Oracle Cloud Infrastructure Data Integration workspace.

You can view summary information of a data asset, access connections, and view data entities in a schema or bucket. Select a data asset to navigate to the details page of the data asset. You can also edit or delete the data asset from the details page.

Summary

In the summary section, you can view data asset details such as type and description. Depending on the type of data source, you can also view the host connection information.

Connections

On the data asset details page, select Connections to view the list of connections available to you. On the list, the Actions menu for a connection has these options:

  • Edit: Edits the connection details.
  • Make Default: Designates this connection as the default. The action is only applicable to a connection that is not designated as the default.
  • Test Connection: Tests whether a connection can be established.
  • Copy Connection Key: Copies to the clipboard the key of the connection, which you can use with APIs.
  • Delete: Deletes this connection.
    Note

    You cannot delete the connection that is designated as the default connection.

Schemas

On the details page of a data asset that is not Oracle Object Storage, select Schemas to view the list of schemas available to you through a connection in the data asset. If there is more than one connection in the data asset, select a connection under Filters, then click a schema to view the data entities in that schema.

Buckets

On the details page of an Oracle Object Storage data asset, select Buckets to view the list of buckets available to you. Select the compartment under List of Scope, then click a bucket to view the data entities in that bucket.

Data Entities (Schema)

Available data entities are listed on the schema details page. Select a data entity to view the entity details. On the data entity details page, click Attributes to list the attribute names and data types. Click Data to list the data rows in that data entity. In the Data table, click an attribute header to view the data and attribute profile.

Data Entities (Bucket in Oracle Object Storage)

Available data entities are listed on the schema (bucket) details page. Select a data entity to view the entity details. On the data entity details page, click Attributes to list the attribute names and data types. Click Data to list the data rows in that data entity.

For a CSV, JSON, Parquet or Avro data entity, the Attributes and Data lists are empty until you specify the Formatting Parameters and retrieve the attributes:

  • Select the File Type of the data entity.
  • For CSV and JSON files, select the Compression Type of the file. If you do not know the compression algorithm that is used to compress the file, use Auto (Default). For Parquet and Avro files, only Auto (Default) is available as the Compression Type.
  • Specify how to parse the attributes retrieved, if applicable. For CSV files, you can specify to include a header, the encoding, escape character, delimiter, and quote character. For JSON, specify the encoding.
  • Click Get Attributes to fetch the data entity's attributes.
  • After the data entity's attributes have been successfully retrieved, click Data to list the data rows.

In the Data table, click an attribute header to view the data and attribute profile.

Note

A data and attribute profile is not supported on these attribute data types:
  • BLOB
  • RAW
  • BINARY
  • BINARY_DOUBLE
  • BINARY_FLOAT
  • CLOB
  • NCLOB
  • SDO_GEOMETRY
  • XMLTYPE
  • XMLFORMAT
  • COMPLEX
  • VARBINARY

Editing a Data Asset

In the Console, you can only edit a data asset from the Data Assets page. You can also update a data asset using the API. When you edit a data asset, you can modify the data asset's details, select or add new connections, and change the default connection.

To edit a data asset:

  1. In the tab bar, click Open tab (plus icon), and then select Data Assets.
  2. On the Data Assets page, select a data asset from the list and then click Edit.

    You can also open the data asset's Actions menu and select Edit.

  3. On the Edit Data Asset page, you can modify the data asset details, select or add new connections, or select a new default connection.
  4. Click Save.
After you save your changes, you're brought back to the Data Assets page.

Editing a Connection

You edit connections from a data asset's details page.

To edit a connection:

  1. In the tab bar, click Open tab (plus icon) and then select Data Assets.
  2. On the Data Assets page, select the data asset that has the connection you want to edit.
  3. On the data asset details page, click Connections, then select Edit from the connection's Actions menu.
  4. In the Edit Connection panel, edit the fields as needed.

    If the data asset has only one connection, you cannot deselect the check box Make this the default connection.

  5. (Optional) Click Test Connection to ensure that a connection can be established.

    A success or failure message displays, indicating whether the test is successful or not. A successful test is not required to edit the connection.

  6. Click Save Connection.

Deleting a Data Asset

When you delete a data asset, you also permanently delete its connections. Once deleted, the data asset and its connections cannot be restored. You can delete a data asset using the Console or the APIs.

To delete a data asset:

  1. In the tab bar, click Open tab (plus icon), and then select Data Assets.
  2. On the Data Assets page, select the data asset you want to delete and then click Delete.

    You can also select Delete from the data asset's Actions menu.

  3. Confirm that you want to delete the data asset and its connections, and click Delete.

Unicode Support

Data Integration supports the Unicode standard, which is a universal character encoding standard for written characters and text in any language. The Unicode standard provides a unique number for every character regardless of the platform, device, or application. For example, 0041 is the Unicode character for the English letter "A".

Data Integration supports Unicode characters (including multibyte characters) in data and metadata.

Unicode support in data means that the attributes and attribute values in your source and target data assets can include Unicode and multibyte characters. You can also enter Unicode and multibyte characters in expressions. For JSON and CSV Object Storage data assets, the default encoding is UTF-8, and you cannot change it.

Unicode support in metadata means that the data entity and schema names of your data assets can include Unicode and multibyte characters. You can also enter Unicode and multibyte characters for names and descriptions when working with objects in Data Integration.

In the Unicode standard, a unique number assigned to a Unicode character is a code point. Currently, Data Integration supports the following Unicode code points and range of code points:

Code Point or RangeCharacterNumber of Characters Supported
Basic Latin characters
0024$ (dollar sign)1
0041 - 005AA to Z26
005F_ (underscore)1
0061 - 007Aa to z26
Latin-1 Supplement characters
00C0 - 00D6Latin-1 Supplement characters with accents23
00D8 - 00F631
00F8 - 00FF8
Characters in 46 ranges from Latin Extended-A to Greek Extended
0100 - 1FFFCharacters in the following named ranges: Latin Extended-A, Latin Extended-B, IPA Extensions, Spacing Modifier Letters, Combining Diacritical Marks, Greek and Coptic, Cyrillic, Cyrillic Supplementary, Armenian, Hebrew, Arabic, Syriac, Thaana, Devanagari, Bengali, Gurmukhi, Gujarati, Oriya, Tamil, Telugu, Kannada, Malayalam, Sinhala, Thai, Lao, Tibetan, Myanmar, Georgian, Hangul Jamo, Ethiopic, Cherokee, Unified Canadian Aboriginal Syllabics, Ogham, Runic, Tagalog, Hanunoo, Buhid, Tagbanwa, Khmer, Mongolian, Limbu, Tai Le, Khmer Symbols, Phonetic Extensions, Latin Extended Additional, Greek Extended7936
Characters in 4 ranges from Hiragana to Hangul Compatibility Jamo
3040 - 318FCharacters in the following named ranges: Hiragana, Katakana, Bopomofo, Hangul Compatibility Jamo336
Characters in 4 CJK (Chinese, Japanese, and Korean) ranges
3300 - 337FCJK Compatibility characters128
3400 - 3D2DCJK Unified Ideographs Extension A characters2350
4E00 - 9FFFCJK Unified Ideographs characters20992
F900 - FAFFCJK Compatibility Ideographs characters512

Understanding Data Type Mappings

Data types from the source and target systems you use are mapped to and mapped from a core set of generic data types in Oracle Cloud Infrastructure Data Integration.

In the set of generic data types, some of the types have additional length or scale properties that you can use to further constrain the data type.

The Expression operator in Data Integration does not yet support all the generic data types. You can create a new attribute based on a generic data type only if the generic type is supported.

Generic Data Type Mappings
Data type Expression support Data type string reference Length Scale
ANYDATA Seeded:/typeSystems/PLATFORM /dataTypes/ANYDATA
BIGINT Yes Seeded:/typeSystems/PLATFORM /dataTypes/BIGINT
BINARY Yes Seeded:/typeSystems/PLATFORM /dataTypes/BINARY
BINARY_DOUBLE Seeded:/typeSystems/PLATFORM /dataTypes/BINARY_DOUBLE
BINARY_FLOAT Seeded:/typeSystems/PLATFORM /dataTypes/BINARY_FLOAT
BLOB Seeded:/typeSystems/PLATFORM /dataTypes/BLOB
BOOLEAN Yes Seeded:/typeSystems/PLATFORM /dataTypes/BOOLEAN
CHAR Yes Seeded:/typeSystems/PLATFORM /dataTypes/CHAR Yes
CLOB Seeded:/typeSystems/PLATFORM /dataTypes/CLOB
DATE Yes Seeded:/typeSystems/PLATFORM /dataTypes/DATETIME
DATETIME Yes Seeded:/typeSystems/PLATFORM /dataTypes/DATETIME
DECIMAL Yes Seeded:/typeSystems/PLATFORM /dataTypes/DECIMAL Yes Yes
DOUBLE Yes Seeded:/typeSystems/PLATFORM /dataTypes/DOUBLE
FIXED Seeded:/typeSystems/PLATFORM /dataTypes/FIXED
FLOAT Yes Seeded:/typeSystems/PLATFORM /dataTypes/FLOAT Yes
INTEGER Yes Seeded:/typeSystems/PLATFORM /dataTypes/INTEGER
INTERVAL DAY TO SECOND Yes Seeded:/typeSystems/PLATFORM /dataTypes/INTERVAL DAY TO SECOND Yes Yes
INTERVAL YEAR TO MONTH Yes Seeded:/typeSystems/PLATFORM /dataTypes/INTERVAL YEAR TO MONTH Yes
LONG Yes Seeded:/typeSystems/PLATFORM /dataTypes/LONG
MONEY Seeded:/typeSystems/PLATFORM /dataTypes/MONEY
NCHAR Seeded:/typeSystems/PLATFORM /dataTypes/NCHAR Yes
NCLOB Seeded:/typeSystems/PLATFORM /dataTypes/NCLOB
NUMBER Seeded:/typeSystems/PLATFORM /dataTypes/NUMBER
NUMERIC Yes Seeded:/typeSystems/PLATFORM /dataTypes/NUMERIC Yes Yes
NVARCHAR Seeded:/typeSystems/PLATFORM /dataTypes/NVARCHAR Yes
REAL Seeded:/typeSystems/PLATFORM /dataTypes/REAL
SMALLINT Yes Seeded:/typeSystems/PLATFORM /dataTypes/SMALLINT
STRING Yes Seeded:/typeSystems/PLATFORM /dataTypes/STRING Yes
TIME Yes Seeded:/typeSystems/PLATFORM /dataTypes/TIME
TIMESTAMP WITH TIME ZONE Yes Seeded:/typeSystems/PLATFORM /dataTypes/TIMESTAMP WITH TIME ZONE Yes
TIMESTAMP Yes Seeded:/typeSystems/PLATFORM /dataTypes/TIMESTAP Yes
TINYINT Yes Seeded:/typeSystems/PLATFORM /dataTypes/TINYINT
VARBINARY Yes Seeded:/typeSystems/PLATFORM /dataTypes/VARBINARY
VARCHAR Yes Seeded:/typeSystems/PLATFORM /dataTypes/VARCHAR Yes
XMLFORMAT Seeded:/typeSystems/PLATFORM /dataTypes/XMLFORMAT
XMLTYPE Seeded:/typeSystems/PLATFORM /dataTypes/XMLTYPE
Mapping: Oracle to and from Generic

The table shows Oracle to Generic type mapping, and Generic to Oracle type mapping.

Oracle to Generic Generic Generic to Oracle
ANYDATA ANYDATA ANYDATA
BIGINT NUMBER
BINARY BLOB
BINARY_DOUBLE BINARY_DOUBLE BINARY_DOUBLE
BINARY_FLOAT BINARY_FLOAT BINARY_FLOAT

BLOB

RAW

LONGRAW

BLOB BLOB
BOOLEAN VARCHAR2
CHAR CHAR CHAR
CLOB CLOB CLOB
DATE DATE DATE
DATETIME TIMESTAMP
DECIMAL NUMBER
DOUBLE NUMBER
FIXED BLOB
FLOAT FLOAT FLOAT
INTEGER NUMBER
INTERVAL DAY TO SECOND INTERVAL DAY TO SECOND INTERVAL DAY TO SECOND
INTERVAL YEAR TO MONTH INTERVAL YEAR TO MONTH INTERVAL YEAR TO MONTH
LONG LONG NUMBER
MONEY NUMBER
NCHAR NCHAR NCHAR
NCLOB NCLOB NCLOB
NUMBER NUMBER
NUMBER NUMERIC NUMBER
NVARCAHR2 NVARCHAR NVARCHAR2
REAL REAL REAL
SMALLINT NUMBER
STRING VARCHAR2
TIME DATE
TIMESTAMP WITH LOCAL TIME ZONE TIMESTAMP WITH TIME ZONE TIMESTAMP WITH TIME ZONE
TIMESTAMP WITH TIME ZONE TIMESTAMP WITH TIME ZONE
TIMESTAMP(0) WITH LOCAL TIME ZONE TIMESTAMP WITH TIME ZONE
TIMESTAMP(0) WITH TIME ZONE TIMESTAMP WITH TIME ZONE

TIMESTAMP

TIMESTAMP(0)

TIMESTAMP TIMESTAMP
TINYINT NUMBER
VARBINARY BLOB

ROWID

UROWID

VARCHAR2

VARCHAR VARCHAR2
XMLFORMAT XMLFORMAT XMLFORMAT
XMLTYPE XMLTYPE XMLTYPE
Mapping: Hive to Generic

The table shows Hive to Generic type mapping.

Hive Generic
ARRAY VARCHAR
BIGINT BIGINT
BOOLEAN BOOLEAN
CHAR CHAR
DATE DATE
DECIMAL DECIMAL
DOUBLE DOUBLE
FLOAT REAL
INT INTEGER
MAP VARCHAR
SMALLINT SMALLINT
STRING VARCHAR
STRUCT VARCHAR
TIMESTAMP TIMESTAMP
TINYINT TINYINT
UNION VARCHAR
VARCHAR VARCHAR
Mapping: MySQL to and from Generic

The table shows MySQL to Generic type mapping, and Generic to MySQL type mapping.

MySQL to Generic Generic Generic to MySQL
BIGINT BIGINT BIGINT
BINARYBINARYBINARY
BINARY_DOUBLE DOUBLE PRECISION
BINARY_FLOAT FLOAT

BLOB

LONGBLOB

MEDIUMBLOB

TINYBLOB

BLOB BLOB
CHAR CHAR CHAR

LONGTEXT

MEDIUMTEXT

TEXT

CLOB LONGTEXT
DATE DATE DATE
DATETIME TIMESTAMP
DECIMAL DECIMAL DECIMAL

DOUBLE

DOUBLE PRECISION

DOUBLE DOUBLE
FLOAT FLOAT FLOAT

INT

MEDIUMINT

INTEGER INT
INTERVAL DAY TO SECOND VARCHAR
INTERVAL YEAR TO MONTH VARCHAR
MONEY NUMERIC
NCHAR VARCHAR
NCLOB VARCHAR
NUMERIC NUMERIC NUMERIC
NVARCHAR VARCHAR
REAL REAL REAL
SMALLINT SMALLINT SMALLINT
TIME TIME TIME

DATETIME

TIMESTAMP WITH TIME ZONE

TIMESTAMP
TIMESTAMP TIMESTAMP
TINYINT TINYINT TINYINT
TINYTEXT STRING

ENUM

VARCHAR

VARCHAR VARCHAR
VARBINARYVARBINARYVARBINARY
XMLTYPE VARCHAR
Mapping: PostgreSQL to Generic

The table shows PostgreSQL to Generic type mapping.

PostgreSQL Generic

BIGINT

BIGSERIAL

BIGINT
BIT BINARY

BIT VARYING

BYTEA

VARBINARY
BOOLEAN BOOLEAN
CHARACTER CHAR
CHARACTER VARYING VARCHAR
DATE DATE
DOUBLE PRECISION DOUBLE
INTEGER INTEGER
JSON VARCHAR(10485760)
NUMERIC NUMERIC
REAL REAL
SERIAL INTEGER
SMALLINT SMALLINT
TEXT VARCHAR(1073741823)

TIME

TIME WITH TIMEZONE

TIMESTAMP

TIMESTAMP WITH TIMEZONE

TIMESTAMP

UUID

ARRAY

VARCHAR
XML XMLTYPE
Mapping: SQL Server to and from Generic

The table shows SQL Server to Generic type mapping, and Generic to SQL Server type mapping.

SQL Server to Generic Generic Generic to SQL Server

bigint

bigint identity

BIGINT bigint
binary

BINARY

binary

BINARY_DOUBLE

BINARY_FLOAT

float
bit BOOLEAN varchar
char CHAR char
date DATE datetime
datetime DATETIME datetime
DOUBLE float
FIXED binary

datetime2

timestamp

TIMESTAMP

decimal

decimal() identity

DECIMAL decimal
float FLOAT float

int identity

int

INTEGER int

INTERVAL DAY TO SECOND

INTERVAL YEAR TO SECOND

varchar
LONG bigint

money

smallmoney

MONEY money
nchar NCHAR nchar
nvarchar NVARCHAR nvarchar

ntext

nvarchar(max)

NCLOB nvarchar(max)
NUMBER numeric

numeric() identity

numeric

NUMERIC numeric
real REAL real
smalldatetime DATETIME

smallint identity

smallint

SMALLINT smallint
STRING varchar
time TIME time

TIMESTAMP WITH TIME ZONE

TIMESTAMP

datetime

tinyint identity

tinyint

TINYINT tinyint
varbinary VARBINARY varbinary

image

varbinary(max)

BLOB varbinary(max)

text

varchar(max)

CLOB varchar(max)

sql_variant

sysname

uniqueidentifier

varchar

VARCHAR varchar
XMLTYPE text
Mapping: File to and from Generic

The table shows File to Generic type mapping, and Generic to File type mapping.

File to Generic Generic Generic to File

Ascii signed zoned decimal

Ascii unsigned zoned decimal

NUMERIC

Binary signed big endian

Binary signed little endian

Binary unsigned big endian

Binary unsigned little endian

NUMERIC
Date DATE Date

Ebcdic signed zoned decimal

Ebcdic unsigned zoned decimal

NUMERIC

Ebcdic

Fixed Ebcdic

Fixed String

VARCHAR
Numeric NUMERIC
Signed packed decimal NUMERIC
String VARCHAR
Unsigned packed decimal NUMERIC
BIGINT Numeric
BINARY String

BINARY_DOUBLE

BINARY_FLOAT

Numeric

BLOB

BOOLEAN

String

CHAR

CLOB

String
DATETIME Date

DECIMAL

DOUBLE

Numeric
FIXED String
FLOAT Numeric
INTEGER Numeric

INTERVAL DAY TO SECOND

INTERVAL YEAR TO MONTH

String
LONG Numeric
MONEY Numeric

NCHAR

NCLOB

String

NUMBER

NUMERIC

Numeric
NVARCHAR String
REAL Numeric

SMALLINT

TINYINT

Numeric
STRING String
TIME String

TIMESTAMP WITH TIME ZONE

TIMESTAMP

Date
VARBINARY String
VARCHAR String
XMLTYPE String
Mapping: CSV to and from Generic

All type mapping is String.

Mapping: JSON to and from Generic

The table shows JSON to Generic type mapping, and Generic to JSON type mapping.

JSON to Generic Generic Generic to JSON

Null

String

VARCHAR String
BIGINT Number
BINARY String

BINARY_DOUBLE

BINARY_FLOAT

Number
BLOB String
Boolean BOOLEAN Boolean

CHAR

CLOB

String

DATE

DATETIME

String

DECIMAL

DOUBLE

Number
FIXED String

FLOAT

INTEGER

Number

INTERVAL DAY TO SECOND

INTERVAL YEAR TO MONTH

String

LONG

MONEY

Number

NCHAR

NCLOB

NVARCHAR

String
NUMBER Number
Number NUMERIC Number
REAL Number
STRING String

SMALLINT

TINYINT

Number

TIME

TIMESTAMP WITH TIME ZONE

TIMESTAMP

String
VARBINARY String
XMLTYPE String
Mapping: Parquet to and from Generic

The table shows Parquet to Generic type mapping, and Generic to Parquet type mapping.

Parquet to Generic Generic Generic to Parquet

BIGINT

LONG

NUMBER

INT64

BINARY

BSON

FIXED_LEN_BYTE_ARRAY

INT96

BINARY BINARY

BINARY_DOUBLE

BINARY_FLOAT

BLOB

CHAR

CLOB

FIXED

INTERVAL DAY TO SECOND

INTERVAL DAY TO MONTH

NCHAR

NCLOB

NVARCHAR

VARBINARY

XMLTYPE

BINARY
BOOLEAN BOOLEAN BOOLEAN
DATE DATE DATE
DATETIME INT32
DECIMAL DECIMAL DECIMAL
DOUBLE DOUBLE DOUBLE

ENUM

INTERVAL

JSON

UTF8

key

VARCHAR UTF8
FLOAT FLOAT FLOAT

INTEGER

MONEY

SMALLINT

TINYINT

INT32
REAL DOUBLE
STRING UTF8
TIME TimeType
TIMESTAMP WITH TIME ZONE TimestampType
TIMESTAMP TimestampType

INT32

INT64

TIMESTAMP_MICROS

TIMESTAMP_MILLIS

TIME_MICROS

TIME_MILLIS

NUMERIC INT32
Mapping: Avro to and from Generic

The table shows Avro to Generic type mapping, and Generic to Avro type mapping.

Avro to Generic Generic Generic to Avro
bytes STRING string
ANYDATA string
BIGINT long
BINARY string
BINARY_DOUBLE string
BINARY_FLOAT string
BLOB string
boolean BOOLEAN boolean
CHAR string
CLOB string
DATE string
DATETIME string
DECIMAL double
double DOUBLE double
FIXED string
float FLOAT float
int INTEGER int
INTERVAL DAY TO SECOND string
INTERVAL YEAR TO MONTH string
long LONG long
MONEY double
NCHAR string
NCLOB string
NUMBER int
NUMERIC int
NVARCHAR string
REAL float
SMALLINT int
string STRING string
TIME string
TIMESTAMP WITH TIME ZONE string
TIMESTAMP string
TINYINT int
VARBINARY string
null VARCHAR string
XMLFORMAT string
XMLTYPE string
Mapping: Fusion Applications (BICC) to and from Generic

The table shows Oracle Fusion Applications using Oracle Business Intelligence Cloud Connector (BICC) to Generic type mapping, and Generic to Oracle Fusion Applications using BICC type mapping.

Oracle Fusion Applications using BICC to GenericGenericGeneric to Oracle Fusion Applications using BICC
NUMERICNUMERICNUMERIC
VARCHARVARCHARVARCHAR
DATEDATEDATE
TIMESTAMPTIMESTAMPTIMESTAMP

Using the API

For information about using the API and signing requests, see REST APIs and Security Credentials. For information about SDKs, see Software Development Kits and Command Line Interface.

Schema operations

Use the following operations to manage schemas:

Data Entity operations

Use the following operations to manage data entities: