> For the complete documentation index, see [llms.txt](https://docs.skyone.cloud/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.skyone.cloud/skyone-studio/modulos/configuracoes-and-operacoes/configuracoes-de-modulos/conectividade-banco-de-dados.md).

# Conectividade: Banco de Dados

### Visão Geral <a href="#visao-geral" id="visao-geral"></a>

A conectividade de **Banco de Dados** é usada para permitir acesso direto às informações dos principais Sistemas Gerenciadores de Bancos de Dados do mercado: MYSQL, POSTGRESQL, SQL SERVER, FIREBIRD e ORACLE.

Para este tipo de conectividade, o **Skyone Studio** permite comandos SQL, tais como: SELECT, UPDATE, DELETE e CREATE, dentre outros.

As operações com SELECT são as mais comuns. Elas permitem uma query segura no banco de dados, retornando as informações em um JSON estruturado.&#x20;

As operações de UPDATE, DELETE e CREATE são usadas quando o sistema não tem processos criados e expostos com APIs e exigem um controle maior, já que o Banco de Dados será alterado diretamente. Recomendamos o uso de views ou tabelas temporárias, que serão processadas posteriormente.

***

#### Como conectar uma conta <a href="#como-conectar-uma-conta" id="como-conectar-uma-conta"></a>

Após a definição do tipo de conectividade, o próximo passo consiste em escolher o **tipo de autenticação**. Somente após dessas definições é que você poderá adicionar uma nova conta, além de poder selecionar, editar ou remover uma das contas previamente cadastradas.

Para adicionar uma conta conectada, clique em "**Conta conectada"** e, em seguida, "**Adicionar conta conectada".**

Siga os passos de acordo com o tipo escolhido em **Banco de dados (tipo de autenticação)**:

<details>

<summary>MySQL</summary>

Ao escolher a opção **"Adicionar conta conectada"**, o seguinte modal será apresentado:

<figure><img src="/files/RZBAjFssPR32LYVZIb6Z" alt=""><figcaption></figcaption></figure>

Preencha os dados, sendo que:

1. **Terminal** (opcional): caso tenha um terminal configurado, selecione-o para que a conexão seja feita através do "**Agente"** correspondente;
2. **Nome da conta**: nome da conta cadastrada;
3. **Host:** IP do host do banco de dados;&#x20;
4. **Porta**: número da porta;
5. **Usuário;**
6. **Senha;**
7. **Nome do banco de dados** (opcional).

Após preencher os dados, clique em "**Criar conta"**.

Pronto! Sua conta conectada está criada e poderá ser utilizada por outros módulos e fluxos, aparecendo entre as opções de contas configuradas em ambos os casos.

</details>

<details>

<summary>PostgreSQL</summary>

Ao escolher a opção "**Adicionar conta conectada"**, o seguinte modal será apresentado:

<figure><img src="/files/9sRNkmnGGXpc9v8CXsTr" alt=""><figcaption></figcaption></figure>

Preencha os dados, sendo que:

1. **Terminal** (opcional): caso tenha um terminal configurado, selecione-o para que a conexão seja feita através do "**Agente"** correspondente;
2. **Nome da conta**: nome da conta cadastrada;
3. **Host:** IP do host do banco de dados;&#x20;
4. **Porta**: número da porta;
5. **Usuário;**
6. **Senha;**
7. **Nome do banco de dados** (opcional).

Após preencher os dados, clique em "**Criar conta"**.

Pronto! Sua conta conectada está criada e poderá ser utilizada por outros módulos e fluxos, aparecendo entre as opções de contas configuradas em ambos os casos.

</details>

<details>

<summary>SQL Server</summary>

Ao escolher a opção "**Adicionar conta conectada"**, o seguinte modal será apresentado:

<figure><img src="/files/CGCCubhDEywIPf4S4UBP" alt=""><figcaption></figcaption></figure>

Preencha os dados, sendo que:

1. **Terminal** (opcional): caso tenha um terminal configurado, selecione-o para que a conexão seja feita através do "**Agente"** correspondente;
2. **Nome da conta**: nome da conta cadastrada;
3. **Host:** IP do Host do banco de dados ;
4. **Porta**: número da porta;
5. **Usuário;**
6. **Senha;**
7. **Nome do banco de dados** (opcional);
8. **AppKey** (opcional): chave da aplicação;

Após preencher os dados, clique em "**Criar conta"**.

Pronto! Sua conta conectada está criada e poderá ser utilizada por outros módulos e fluxos, aparecendo entre as opções de contas configuradas em ambos os casos.

</details>

<details>

<summary>FireBird</summary>

Ao escolher a opção "**Adicionar conta conectada"**, o seguinte modal será apresentado:

<figure><img src="/files/LsCxa90BRhySJBWIB7Bo" alt=""><figcaption></figcaption></figure>

Preencha os dados, sendo que:

1. **Terminal** (opcional): caso tenha um terminal configurado, selecione-o para que a conexão seja feita através do "**Agente"** correspondente;
2. **Nome da conta**: nome da conta cadastrada;
3. **Host:** IP do Host do banco de dados;&#x20;
4. **Porta**: número da porta;
5. **Usuário;**
6. **Senha;**
7. **Nome do banco de dados** (opcional).

Após preencher os dados, clique em "**Criar conta"**.&#x20;

Pronto! Sua conta conectada está criada e poderá ser utilizada por outros módulos e fluxos, aparecendo entre as opções de contas configuradas em ambos os casos.

</details>

<details>

<summary>FireBird 3+</summary>

Ao escolher a opção "**Adicionar conta conectada"**, o seguinte modal será apresentado:

<figure><img src="/files/eCe6wgBHUAIp2vsyW1a8" alt=""><figcaption></figcaption></figure>

Preencha os dados, sendo que:

1. **Terminal** (opcional): caso tenha um terminal configurado, selecione-o para que a conexão seja feita através do "**Agente"** correspondente;
2. **Nome da conta**: nome da conta cadastrada;
3. **Host:** IP do Host do banco de dados;&#x20;
4. **Porta**: número da porta;
5. **Usuário;**
6. **Senha;**
7. **Nome do banco de dados** (opcional).

Após preencher os dados, clique em "**Criar conta"**.&#x20;

Pronto! Sua conta conectada está criada e poderá ser utilizada por outros módulos e fluxos, aparecendo entre as opções de contas configuradas em ambos os casos.

</details>

<details>

<summary>Oracle</summary>

Ao escolher a opção "**Adicionar conta conectada"**, o seguinte modal será apresentado:

<figure><img src="/files/Apr2szeYaMDEOWlHGKiX" alt=""><figcaption></figcaption></figure>

Preencha os dados, sendo que:

1. **Terminal** (opcional): caso tenha um terminal configurado, selecione-o para que a conexão seja feita através do "**Agente"** correspondente;
2. **Nome da conta**: nome da conta cadastrada;
3. **Host:** IP do Host do banco de dados;
4. **Porta**: número da porta;
5. **Usuário;**
6. **Senha;**
7. **Nome do banco de dados** (opcional);
8. **Schema** (opcional): conjunto de objetos (tabelas, visualizações, etc.) que pertencem a sua conta.

Após preencher os dados, clique em "**Criar conta"**.&#x20;

Pronto! Sua conta conectada está criada e poderá ser utilizada por outros módulos e fluxos, aparecendo entre as opções de contas configuradas em ambos os casos.<br>

</details>

<details>

<summary>SAP Hana</summary>

Ao escolher a opção "**Adicionar conta conectada"**, o seguinte modal será apresentado:

<figure><img src="/files/z5lOjoYbMnidJKn0ZMcD" alt=""><figcaption></figcaption></figure>

Preencha os dados, sendo que:

1. **Terminal** (opcional): caso tenha um terminal configurado, selecione-o para que a conexão seja feita através do "**Agente"** correspondente;
2. **Nome da conta**: nome da conta cadastrada;
3. **Host:** IP do Host do banco de dados;
4. **Porta**: número da porta;
5. **Usuário;**
6. **Senha;**
7. **Nome do banco de dados** (opcional);
8. **Schema** (opcional): conjunto de objetos (tabelas, visualizações, etc.) que pertencem a sua conta.

Após preencher os dados, clique em "**Criar conta"**.&#x20;

Pronto! Sua conta conectada está criada e poderá ser utilizada por outros módulos e fluxos, aparecendo entre as opções de contas configuradas em ambos os casos.<br>

</details>

<details>

<summary>InterSystems Caché</summary>

Ao escolher a opção **"Adicionar conta conectada"**, o seguinte modal será apresentado:

<figure><img src="/files/vEOm58iX5Gh9b4PnNJAO" alt=""><figcaption></figcaption></figure>

Preencha os dados, sendo que:

1. **Terminal** (opcional): caso tenha um terminal configurado, selecione-o para que a conexão seja feita através do "**Agente"** correspondente;
2. **Nome da conta**: nome da conta cadastrada;
3. **Host:** IP do Host do banco de dados;
4. **Porta**: número da porta;
5. **Usuário;**
6. **Senha;**
7. **Nome do banco de dados** (opcional);
8. **Namespace** (opcional): deve ter o mesmo valor do campo "nome do banco de dados".&#x20;

Após preencher os dados, clique em "**Criar conta"**.

Pronto! Sua conta conectada está criada e poderá ser utilizada por outros módulos e fluxos, aparecendo entre as opções de contas configuradas em ambos os casos.

</details>

<details>

<summary>ODBC</summary>

Ao escolher a opção **"Adicionar conta conectada"**, o seguinte modal será apresentado:

<figure><img src="/files/wwrNhOf0vYvy4zyhHGHc" alt=""><figcaption></figcaption></figure>

Preencha os dados, sendo que:

1. **Terminal**: selecione um [terminal](/skyone-studio/terminais-and-agente.md) previamente configurado para que a conexão seja feita através do "**Agente"** correspondente;
2. **Nome da conta**: nome da conta cadastrada;
3. **String de conexão**: sequência de caracteres que fornece todas as informações necessárias para a conexão ao banco de dados ODBC.

Após preencher os dados, clique em "**Criar conta"**.

Pronto! Sua conta conectada está criada e poderá ser utilizada por outros módulos e fluxos, aparecendo entre as opções de contas configuradas em ambos os casos.

</details>

<details>

<summary>MongoDB</summary>

Ao escolher a opção **"Adicionar conta conectada"**, o seguinte modal será apresentado:

<figure><img src="/files/psthdYUBFr00f6n4wB09" alt=""><figcaption></figcaption></figure>

Preencha os dados, sendo que:

1. **Nome da conta**: nome da conta a ser cadastrada;
2. **String de conexão**: sequência de caracteres que fornece todas as informações necessárias para a conexão ao banco de dados MongoDB.

Após preencher os dados, clique em "**Criar conta"**.

Pronto! Sua conta conectada está criada e poderá ser utilizada por outros módulos e fluxos, aparecendo entre as opções de contas configuradas em ambos os casos.

</details>

Para finalizar, clique em "**Salvar alterações"** para definir as configurações do seu módulo.

{% hint style="warning" %}
Importante: após salvar as alterações, não será possível mais alterar o Tipo de conectividade e/ou Tipo de autenticação (Banco de Dados).
{% endhint %}

Próximo passo: [Crie operações para o módulo](/skyone-studio/modulos/configuracoes-and-operacoes/operacoes-de-modulos.md)

Leia também:  [Gestão das contas conectadas](/skyone-studio/modulos/configuracoes-and-operacoes/configuracoes-de-modulos/gestao-das-contas-conectadas.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.skyone.cloud/skyone-studio/modulos/configuracoes-and-operacoes/configuracoes-de-modulos/conectividade-banco-de-dados.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.