CData Connector is a universal connector for accessing live Application, Database, and WebAPI data via CData JDBC drivers embedded in the CData Virtuality Server.
Type Name
cdata
Connection Properties
Template name: cdata
Appropriate translator name: cdata
Properties:
driver
(CData driver name, required)driver-class
jdbc-properties
(CData driver properties separated by semicolons)encrypted-jdbc-properties
(CData driver properties to be encrypted and masked in UI and logs separated by semicolons)
Example
CALL SYSADMIN.createConnection(
name
=>
'cdata'
, jbossCliTemplateName =>
'cdata'
, connectionOrResourceAdapterProperties =>
'driver=excel,jdbc-properties="ExcelFile=D:/sample.xlsx"'
, encryptedProperties =>
''
);;
CALL SYSADMIN.createDatasource(
name
=>
'cdata'
, translator =>
'cdata'
, modelProperties =>
''
, translatorProperties =>
''
, encryptedModelProperties =>
''
, encryptedTranslatorProperties =>
''
);;
JDBC properties per driver can be found in the SYSADMIN.CDataJdbcProperties
system table.
Supported Drivers
The following drivers are currently supported by the CData Virtuality Server:
Driver name | Product name |
---|---|
aas | Azure Analysis Services |
activedirectory | Active Directory |
amazondynamodb | Amazon DynamoDB |
apachekafka | Apache Kafka |
cds | Microsoft Dataverse |
connect | JDBC-ODBC Bridge |
cosmosdb | CosmosDB |
elasticsearch | ElasticSearch |
excel | Microsoft Excel |
googlebigquery | Google Big Query |
googlesheets | Google Sheets |
jira | Jira |
kintone | Kintone |
monday | Monday.com |
neo4j | Neo4J |
netsuite | NetSuite |
paylocity | Paylocity |
sageintacct | Sage Intacct |
sapbusinessone | SAP BusinessOne |
sapbydesign | SAP ByDesign |
sapconcur | SAP Concur |
saperp | SAP |
sapgateway | SAP Netweaver Gateway |
saphybrisc4c | SAP Hybris |
sapsuccessfactors | SAP Success Factor |
servicenow | ServiceNow |
ssas | SQL Analysis Services |
workday | Workday |
zohocrm | Zoho CRM |
zuora | Zuora |
Translator Properties
Translator Properties Shared by All JDBC Connectors
(Properties listed in alphabetical order)
To view the full table, click the expand button in its top right corner
Name | Description | Default value |
---|---|---|
| Sets a template to convert Examples comparisonStringConversion=%s -- no conversion will be applied comparisonStringConversion= binary %s -- WHERE binary someStringExpression LIKE someOtherStringExpression comparisonStringConversion=(%s COLLATE Latin1_General_CS_AS) -- WHERE (someStringExpression COLLATE Latin1_General_CS_AS LIKE someOtherStringExpression) |
|
| Database time zone, used when fetching date, time, or timestamp values | System default time zone |
| Specific database version, used to fine-tune pushdown support | Automatically detected by the server through the data source JDBC driver, if possible |
| Only considered when |
|
| If |
|
| Maximum size of prepared insert batch |
|
| Sets a template to convert Examples OrderByStringConversion=%s -- no conversion will be applied OrderByStringConversion=( binary %s) -- ORDER BY (binary someStringExpression) OrderByStringConversion= cast ((%s) as varchar (2000) ccsid 1208) -- ORDER BY cast((someStringExpression) as varchar(2000) ccsid 1208) |
|
| If |
|
| Forces a translator to issue a Example SELECT x.* FROM table ( CALL "dwh.native" ( "request" => 'SELECT query, pid, elapsed, substring FROM svl_qlog ORDER BY STARTTIME DESC LIMIT 200' ) ) w , ARRAYTABLE( w.tuple COLUMNS query string, pid integer , elapsed string, "substring" string ) x; |
|
| If If |
|
| If If |
|
| If |
|
| if |
|
| Embeds a / comment / leading comment with session/request id in the source SQL query for informational purposes |
|
The names of the translator properties are case-sensitive.
Data Source Properties
Data Source Properties Shared by All JDBC Connectors
(Properties listed in alphabetical order)
To view the full table, click the expand button in its top right corner
Name | Description | Default |
---|---|---|
| Replaces |
|
| Database catalogs to use. Can be used if the Only for Microsoft SQL Server and Snowflake:
| Exasol: EXA_DB All others: empty |
|
Please note that writing into a data source is only possible if this parameter is set. | Empty |
| Turns on metadata cache for a single data source even when the global option is turned off. Together with |
|
| Case-insensitive regular expression that will exclude a matching fully qualified procedure name from import | Empty |
| Comma-separated list of schemas (no | Oracle: APEX_PUBLIC_USER, DIP, FLOWS_040100, FLOWS_020100, FLOWS_FILES, MDDATA, ORACLE_OCM, SPATIAL_CSW_ADMIN_USR, SPATIAL_WFS_ADMIN_USR, XS$ NULL , BI, HR, OE, PM, IX, SH, SYS, SYSTEM, MDSYS, CTXSYS All others: empty |
| Case-insensitive regular expression that will exclude a matching fully qualified table name from import. Does not speed up metadata loading. Here are some examples: 1. Excluding all tables in the (source) schemas importer.excludeTables=(.*[.]sys[.].*|.*[.]INFORMATION_SCHEMA[.].*) 2. Excluding all tables except the ones starting with "public.br" and "public.mk" using a negative lookahead: importer.excludeTables=(?! public \.(br|mk)).* 3. Excluding "tablename11" from the list ["tablename1", "tablename11", "company", "companies"]: importer.excludeTables=.*\.(?!\btablename1\b|\bcompan).*
| Empty |
| Fetch size assigned to a resultset on loading metadata | No default value |
| If set to |
|
| If set to |
|
| If set to |
|
| If set to Please note that it is currently not possible to import procedures which use the same name for more than one parameter (e.g. same name for |
|
| Set to |
|
| If set to |
|
| If set to |
|
| Procedure(s) to import. If omitted, all procedures will be imported. | Empty |
| If set to |
|
| If set to |
|
| If set to |
|
| If set to |
|
| Schema(s) to import. If omitted or has "" value, all schemas will be imported. | Empty |
| If set to |
|
| Table(s) to import. If omitted, all tables will be imported. | Empty |
| Comma-separated list (without spaces) of table types to import. Available types depend on the DBMS. Usual format: Other typical types are | Empty |
| If set to | |
| If set to Please note that this may lead to objects with duplicate names when importing from multiple schemas, which results in an exception |
|
| If set to |
|
| If set to |
|
Escaping wildcards in importer.catalog
available since v4.0.8
Default values
and importer.catalog='EXA_DB'
importer.useCatalogName=FALSE
available since v4.4
importer.loadSourceSystemFunctions
is available since v4.6
set to importer.importProcedures
TRUE
by default for CData connector since v4.7
Limitations
This is a preview version of the CData connector, and some functions are not yet implemented. The limitations include the following:
No functions are pushed down;
Pushdown for
JOIN
,WITH
,UNION
, and other complex queries is not supported;The JDBC-ODBC Bridge driver can be used only on Windows.
CData connector available since v4.6
SAP Netweaver Gateway driver available since v4.7
Active Directory, SAP Success Factor, Zoho CRM, and Apache Kafka drivers available since v4.8
Sage Intacct, Jira, Google Sheets, Paylocity, Kintone, Workday, ServiceNow, and Zuora drivers available since v4.9