# Integração com Banco de Dados ## **Finalidade** \ Ao adicionar uma ou mais integrações a bancos de dados públicos ou privados, você permite que aplicativos avançados e outras capacidades consultem seus dados de forma segura usando o poder de agentes de IA. ### **Suporte** Atualmente, a SkyDeck AI suporta bancos de dados Postgresql e armazéns de dados Redshift hospedados na AWS. Não é particularmente difícil oferecer suporte a outras fontes de dados, mas tivemos que começar de algum lugar. Se você possui outra fonte de dados que deseja usar, entre em contato com o suporte para priorizar uma integração que atenda às suas necessidades. ### **Instruções** **Os seguintes são os passos para integrar sua base de dados com o SkyDeck AI:** 1. Obtenha ou monte uma URL de conexão. 2. Adicione a URL de conexão à seção Integrações no Centro de Controle. 3. Atribua essa integração a uma ferramenta inteligente ou agente AI na seção Ferramentas do Centro de Controle. ### URL de Conexão Se você tiver sorte, um administrador de banco de dados lhe entregará uma URL padrão pronta para uso que aponta para o seu banco de dados. Se não, você precisará montar uma para adicionar acesso ao SkyDeck ao seu banco de dados. Essas instruções tornarão essa tarefa bastante fácil. \ \ Para configurar uma URL de conexão para um banco de dados PostgreSQL ou Amazon Redshift hospedado na Amazon AWS, você precisa de várias informações sobre o seu banco de dados: o host, número da porta, nome do banco de dados, nome do usuário e senha. Aqui está um guia passo a passo: #### Banco de dados PostgreSQL 1. **Host**: Este é o endereço do servidor onde o seu banco de dados está hospedado. Deve ser algo como `your-db-instance-name.region-name.rds.amazonaws.com` para AWS RDS PostgreSQL ou `your-cluster-name.region-name.redshift.amazonaws.com` para Amazon Redshift. 2. **Número da Porta**: Esta é a porta na qual o seu servidor de banco de dados está escutando. A porta padrão para PostgreSQL é 5432, e para Amazon Redshift, é 5439. 3. **Nome do Banco de Dados**: Este é o nome do banco de dados ao qual você deseja se conectar. 4. **Nome de usuário & Senha**: Estas são as credenciais que você precisa para se autenticar no banco de dados. O formato geral de uma URL de conexão é o seguinte: ``` protocolo://nome_de_usuario:senha@host:porta/banco_de_dados ``` Veja como você pode criar uma URL de conexão: 1. Comece com o protocolo, que é 'postgresql' para PostgreSQL e 'redshift' para Amazon Redshift: ``` postgresql:// ``` 2. Em seguida, adicione seu nome de usuário e senha, separados por um dois pontos. Se o seu nome de usuário ou senha inclui caracteres especiais, você precisará codificá-los em URL. Por exemplo, se o seu nome de usuário é 'user' e sua senha é 'pass', torna-se: ``` postgresql://user:pass@ ``` 3. Depois, adicione seu host e porta, separados por dois pontos: ``` postgresql://user:pass@your-db-instance-name.region-name.rds.amazonaws.com:5432/ ``` 4. Finalmente, adicione o nome do seu banco de dados: ``` postgresql://user:pass@your-db-instance-name.region-name.rds.amazonaws.com:5432/nome_do_seu_banco_de_dados ``` Pronto! Você criou a sua URL de conexão. Certifique-se de substituir 'user', 'pass', 'your-db-instance-name.region-name.rds.amazonaws.com', '5432', e 'nome\_do\_seu\_banco\_de\_dados' pelos detalhes reais do seu banco de dados. Lembre-se de não compartilhar esta URL com ninguém, pois contém informações sensíveis como seu nome de usuário e senha. #### RedShift DWH O URL para um banco de dados Redshift seria muito semelhante, mas com algumas diferenças-chave: 1. O protocolo seria 'jdbc:redshift' em vez de 'postgresql'. Isso ocorre porque JDBC (Java Database Connectivity) é comumente usada para conectar a bancos de dados Redshift. 2. A porta padrão para o Redshift é 5439, não 5432. Aqui está o formato geral para um URL de conexão Redshift: ``` jdbc:redshift://host:port/database ``` Então, se você fosse criar um URL de conexão para o Redshift, ele se pareceria com algo assim: ``` jdbc:redshift://user:pass@your-cluster-name.region-name.redshift.amazonaws.com:5439/your-database-name ``` Lembre-se de substituir 'user', 'pass', 'your-cluster-name.region-name.redshift.amazonaws.com', '5439' e 'your-database-name' pelos detalhes reais do seu banco de dados. ### Adicionando Sua Integração Cole sua URL de conexão na seção "Credenciais" de Adicionar Integração. Você pode selecionar PostgreSQL para um banco de dados postgresql ou Redshift. Você pode usar qualquer nome que desejar para a Integração, mas sugerimos que escolha algo que o ajude a identificar o banco de dados específico associado.
Adicionar uma Integração de DB ao Centro de Controle
### Acessando Seus Dados Através do SkyDeckAI Hoje, os usuários podem acessar seu banco de dados usando as ferramentas de Analista disponíveis para eles no GenStudio. Como administrador, você pode atribuir uma integração a uma ferramenta de analista na seção Ferramentas do Control Center. Você pode então atribuir tags a essa ferramenta para garantir que apenas pessoas autorizadas tenham acesso a essa ferramenta e ao acesso ao banco de dados em seu espaço de trabalho SkyDeck AI GenStudio.
Adicionando uma Integração de DB ao Analista Bob

Adicione uma integração de banco de dados a uma ferramenta que a suporte para compartilhar acesso com os membros de sua organização.

#### Notas de Segurança * Crie um usuário (papel) somente leitura em seu banco de dados para usar com sua integração SkyDeck AI. O SkyDeck não precisa gravar em seu sistema e é mais seguro se você usar credenciais que não tenham mais direitos do que o necessário. No entanto, o usuário deve ser capaz de consultar a estrutura do seu sistema de dados para entendê-lo. * Não compartilhe a URL de acesso, pois contém informações de conexão confidenciais. * Você pode limitar quais usuários em sua organização têm acesso a cada banco de dados, garantindo que ferramentas que o utilizam, como uma cópia do Analyst Bob, sejam atribuídas a tags que correspondam apenas aos usuários que você deseja que tenham acesso. --- # Agent Instructions: 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: ``` GET https://docs.skydeck.ai/pt/integrations/llms-and-databases/database-integration.md?ask= ``` The question should be specific, self-contained, and written in natural language. 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.