# Bancos de dados suportados

Você pode acessar bancos de dados utilizando conectores específicos, como [DB V2](https://docs.digibee.com/documentation/connectors-and-triggers/pt-br/connectors/structured-data/db-v2), [Stream DB V3](https://docs.digibee.com/documentation/connectors-and-triggers/pt-br/connectors/structured-data/stream-db-v3) e [Stored Procedure](https://docs.digibee.com/documentation/connectors-and-triggers/pt-br/connectors/structured-data/stored-procedure).

O suporte a bancos de dados mencionado aqui não se aplica a versões descontinuadas de conectores.

## Bancos de dados suportados por tipo

### Amazon Aurora

A Digibee Integration Platform oferece suporte para ambos os engines do Amazon Aurora.

#### Amazon Aurora MySQL

| Versões suportadas |
| ------------------ |
| 1                  |
| 2                  |
| 3                  |

**String de conexão**

```
jdbc:mysql://<host>:<port>/<database>
```

#### Amazon Aurora PostgreSQL

Todas as versões são suportadas.

**String de conexão**

```
jdbc:postgresql://<host>:<port>/<database>
```

***

### DB2

| Versões suportadas      |
| ----------------------- |
| DB2 level version: 11.5 |
| Driver version: 4.26.14 |

**String de conexão**

```
jdbc:db2://127.0.0.1:1724/dbtest
```

O driver licenciado pela sua empresa junto à IBM deve ser ativado para se conectar às versões suportadas. Este processo é tratado pelo time de suporte da Digibee, mas você deve fornecer o driver JDBC IBM DB2 para ativação. Este processo é exclusivo ao realm do cliente solicitante.

Os recursos disponíveis são baseados na [documentação oficial do DB2](https://www.ibm.com/support/pages/db2-jdbc-driver-versions-and-downloads).

***

### Apache Hive

Suportado via JDBC Connector 2.6.17 para Cloudera Enterprise apenas.

| Versões suportadas      |
| ----------------------- |
| Apache Hive 1.0.0 a 3.1 |

**String de conexão**

```
jdbc:hive2://localhost:10002
```

O driver licenciado pela sua empresa junto à Cloudera deve ser ativado para se conectar às versões suportadas. Este processo é tratado pelo time de suporte da Digibee, mas você deve fornecer o driver JDBC Cloudera para ativação. Este processo é exclusivo ao realm do cliente solicitante.

Os recursos disponíveis são baseados na [documentação oficial do driver JDBC Cloudera](https://docs.cloudera.com/documentation/other/connectors/hive-jdbc/2-6-17.html).

***

### Teradata

| Versões suportadas |
| ------------------ |
| 16.10              |
| 16.20              |
| 17.00              |
| 17.10              |
| 17.20              |

**String de conexão**

```
jdbc:teradata://192.168.64.2/DATABASE=DBC,DBS_PORT=1025
```

O driver licenciado pela sua empresa junto à Teradata deve ser ativado para se conectar às versões suportadas. Este processo é tratado pelo time de suporte da Digibee, mas você deve fornecer o driver JDBC Teradata para ativação. Este processo é exclusivo ao realm do cliente solicitante.

***

### SQL Server

| Versões suportadas                                    |
| ----------------------------------------------------- |
| Microsoft SQL Server 2019                             |
| Microsoft SQL Server 2017                             |
| Microsoft SQL Server 2016                             |
| Microsoft SQL Server 2014                             |
| Microsoft SQL Server 2012                             |
| Microsoft SQL Server 2008 R2                          |
| Azure SQL Database                                    |
| Azure SQL Data Warehouse or Parallel Data Warehouse   |
| Azure SQL Managed Instance (Extended Private Preview) |

**String de conexão**

```
jdbc:sqlserver://[serverName[\instanceName][:portNumber]]
```

Embora a conexão através da versão 2019 do Microsoft SQL Server seja suportada, nem todas as funcionalidades desta versão poderão estar disponíveis.

{% hint style="warning" %}
Ao utilizar a string de conexão como [Global](https://app.gitbook.com/s/cO0A6g1dOsu8BiHYqO67/platform-administration/settings/globals), a barra invertida deve ser escapada (\`\\\\\`) para que o driver identifique corretamente a instância:

```
jdbc:sqlserver://[serverName[\\instanceName][:portNumber]]
```

{% endhint %}

***

### Oracle

| Versões suportadas |
| ------------------ |
| 19.x               |
| 18.3               |
| 12.2 ou 12cR2      |
| 12.1 ou 12cR1      |
| 11.2 ou 11gR2      |

**Strings de conexão**

{% tabs %}
{% tab title="Sintaxe Oracle Net" %}
{% code overflow="wrap" %}

```
jdbc:oracle:thin:@(DESCRIPTION=
(LOAD_BALANCE=on)
(ADDRESS_LIST=
(ADDRESS=(PROTOCOL=TCP)(HOST=host1) (PORT=5221))
(ADDRESS=(PROTOCOL=TCP)(HOST=host2)(PORT=5221)))
(CONNECT_DATA=(SERVICE_NAME=orcl)))
```

{% endcode %}
{% endtab %}

{% tab title="Sintaxe com Nome de Serviço" %}
{% code overflow="wrap" %}

```
jdbc:oracle:thin:@//localhost:5221/orcl
```

{% endcode %}
{% endtab %}
{% endtabs %}

Apenas conexões do tipo *thin* são suportadas. Ao acessar as bases de dados especificadas nessa string de conexão, você concorda que possui as licenças Oracle necessárias.

{% hint style="info" %}
A string de conexão pode conter múltiplos endpoints. O driver tentará conectar a cada um em sequência até obter sucesso. Se você configurar `"oracle.net.connect_timeout"` em **Custom Connection Properties** dos conectores [DB V2](https://docs.digibee.com/documentation/connectors-and-triggers/pt-br/connectors/structured-data/db-v2), [Stream DB V3](https://docs.digibee.com/documentation/connectors-and-triggers/pt-br/connectors/structured-data/stream-db-v3) e [Stored Procedure](https://docs.digibee.com/documentation/connectors-and-triggers/pt-br/connectors/structured-data/stored-procedure), saiba que o timeout se aplica individualmente a cada endpoint, não de forma global.
{% endhint %}

***

### MySQL

| Versões suportadas |
| ------------------ |
| 5.6                |
| 5.7                |
| 8.0                |

**String de conexão**

```
jdbc:mysql://<host>:<port>/<database>
```

A Digibee Integration Platform desabilita a interpretação de strings MariaDB pelo driver MySQL. No entanto, é possível utilizar o driver MariaDB para se conectar a versões mais antigas do MySQL.

***

### MariaDB

| Versões suportadas |
| ------------------ |
| 5.5.3+             |

**String de conexão**

```
jdbc:mariadb://<host>:<port>/<database>
```

A Digibee Integration Platform desabilita a interpretação de strings MariaDB pelo driver MySQL.

***

### Progress

| Versões suportadas |
| ------------------ |
| OpenEdge 10.1.x+   |

**String de conexão**

```
jdbc:datadirect:openedge://hostname:port
```

***

### Sybase

| Versões suportadas |
| ------------------ |
| SAP/Sybase ASE     |

**String de conexão**

```
jdbc:sybase:Tds:host:port
```

***

### PostgreSQL

Todas as versões são suportadas.

**String de conexão**

```
jdbc:postgresql://host:port/database
```

***

### OLAP DataSource via MDX

| Versões suportadas                  |
| ----------------------------------- |
| Hyperion Essbase 7                  |
| Microsoft Analysis Services 2005    |
| Mondrian (sem informação de versão) |
| SAP BW 3.0a+                        |

**Strings de conexão**

{% tabs %}
{% tab title="MS SQL Server" %}
{% code overflow="wrap" %}

```
jdbc:jdbc4olap:http://<server>:<port>/OLAP/msmdpump.dll
```

{% endcode %}
{% endtab %}

{% tab title="Mondrian" %}
{% code overflow="wrap" %}

```
jdbc:jdbc4olap:http://<server>:<port>/mondrian/xmla
```

{% endcode %}
{% endtab %}

{% tab title="SAP BW" %}
{% code overflow="wrap" %}

```
jdbc:jdbc4olap:http://<server>:<port>/sap/bw/soap/xmla?sap-client=number
```

{% endcode %}
{% endtab %}
{% endtabs %}

Esse tipo de conexão utiliza o padrão XMLA (XML for Analysis), que deve estar habilitado no servidor OLAP a ser acessado.

***

### JTOpen for AS/400

Sem informação de compatibilidade.

**String de conexão**

```
jdbc:as400://<server>[:port];prompt=false
```

A porta de Database Access (padrão 8471) deve ser mapeada conforme a [documentação da IBM](https://www.ibm.com/support/pages/tcpip-ports-required-ibm-i-access-and-related-functions). Recomendamos especificar o parâmetro **prompt=false** para que o driver não solicite credenciais, que são passadas automaticamente.

***

### SAP HANA

Sem informação de compatibilidade.

**String de conexão**

```
jdbc:sap://<server>:<port>
```

***

### Firebird

| Versões suportadas |
| ------------------ |
| 2.5+               |

**String de conexão**

```
jdbc:firebirdsql://<HOST>:<PORT>/C:\PATH_TO_DATABASE/DATABASE_FILE.FDB
```

***

### DB Informix

Sem informação de compatibilidade.

{% hint style="warning" %}
Ao acessar as bases de dados especificadas nessa string de conexão, você concorda que possui as licenças IBM necessárias.&#x20;
{% endhint %}

**String de conexão**

```
jdbc:informix-sqli://<HOST>:<PORT>/<DATABASE>:informixserver=<INFORMIX_SERVER>
```

***

### Netsuite

Sem informação de compatibilidade.

{% hint style="warning" %}
Ao acessar as bases de dados especificadas nessa string de conexão, você concorda que possui as licenças da Netsuite necessárias.&#x20;
{% endhint %}

Esse driver suporta somente a operação SELECT.

**String de conexão**

```
jdbc:ns://{Server Host}:{Server Port};ServerDataSource={Server Data Source};encrypted=1;Ciphersuites={Cipher Suite};CustomProperties=(AccountID={Account Id};RoleID={Role Id})
```

***

### Snowflake

{% hint style="warning" %}
Ao acessar as bases de dados especificadas nessa string de conexão, você concorda que possui as licenças da Snowflake necessárias.
{% endhint %}

| Versões suportadas |
| ------------------ |
| 3.51.x+            |

**Strings de conexão**

{% tabs %}
{% tab title="Sintaxe" %}
{% code overflow="wrap" %}

```
jdbc:snowflake://<account_name>.snowflakecomputing.com/?<connection_params>
```

{% endcode %}
{% endtab %}

{% tab title="Exemplo" %}
{% code overflow="wrap" %}

```
jdbc:snowflake://wxyz.us-central1.gcp.snowflakecomputing.com/?db=snowflake_sample_data&sfSchema=TPCH_SF100
```

{% endcode %}
{% endtab %}
{% endtabs %}

Leia a [documentação da Snowflake](https://docs.snowflake.com/en/user-guide/jdbc-configure.html) para saber mais sobre a configuração de parâmetros da string de conexão.

{% hint style="info" %}
A versão 3.10.3 do driver JDBC está sendo utilizada pois versões mais recentes não suportam microsserviços com 64MB de memória (pipeline small na Digibee Integration Platform). Veja o [change log do driver](https://docs.snowflake.com/en/release-notes/client-change-log-jdbc) para mais detalhes.
{% endhint %}

**Limitações conhecidas**

* **CLOB e BLOB:** Não suportados. A opção "Blob as File" não funcionará nos conectores [DB V2](https://docs.digibee.com/documentation/connectors-and-triggers/pt-br/connectors/structured-data/db-v2) e [Stream DB V3](https://docs.digibee.com/documentation/connectors-and-triggers/pt-br/connectors/structured-data/stream-db-v3). Consulte a documentação da Snowflake sobre [tipos de dados não suportados](https://docs.snowflake.com/en/sql-reference/data-types-unsupported.html) e [entrada e saída binárias](https://docs.snowflake.com/en/user-guide/binary-input-output.html).
* **Parâmetros OUT e INOUT:** Não suportados. O driver retorna `SQLFeatureNotSupportedException`.
* **Campos BINARY e VARBINARY:** Não suportados em Batch Mode.
* **Erros em Batch Mode:** O driver não retorna contagens de sucesso ou erro — apenas a primeira exceção SQL é retornada e toda a transação sofre rollback, mesmo com "rollbackOnError" desmarcado.