Saltar para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://docs.replit.com/llms.txt

Use this file to discover all available pages before exploring further.

Este guia mostra como conectar ao banco de dados do seu aplicativo Replit a partir do seu código usando os métodos de conexão:
  • Conexão direta: Conexão para desenvolvimento e cargas de trabalho mais leves
  • Pool de conexões: Gerenciamento eficiente de conexões para aplicativos de produção com alto tráfego
Para determinar qual tipo de conexão você precisa, consulte Como escolher seu driver e tipo de conexão na documentação do Neon.
Use o Agent para gerar código que se conecte ao seu banco de dados existente.

​
Pré-requisitos

Antes de começar, certifique-se de ter o seguinte:
  • Um banco de dados criado no seu aplicativo Replit
  • Conhecimento de programação e gerenciamento de conexões de banco de dados

​
Crie um script de conexão

Este tutorial não fornece exemplos para todas as linguagens de programação. Use a documentação do driver PostgreSQL para a linguagem de programação do seu projeto ou peça ao Agent para traduzir os exemplos de código.
1

Crie um diretório para seu script de conexão

Crie um diretório no nível superior do seu projeto chamado scripts.
2

Crie um script de conexão

Crie um arquivo neste diretório e cole um dos seguintes exemplos de conexão.
const { Client } = require('pg')

async function queryDatabase() {
  const databaseUrl = process.env.DATABASE_URL
  const client = new Client({ connectionString: databaseUrl })

  try {
    await client.connect()
    const result = await client.query('SELECT * FROM users WHERE active = true')
    return result.rows
  } finally {
    await client.end()
  }
}

queryDatabase()
  .then(rows => console.log(rows))
  .catch(err => console.error(err))

const { Pool } = require('pg')

async function queryDatabasePool() {
  const databaseUrl = process.env.DATABASE_URL
  // altera a URL para usar o pool de conexões do Neon
  const poolUrl = databaseUrl.replace('.us-east-2', '-pooler.us-east-2')
  const pool = new Pool({
    connectionString: poolUrl,
    max: 10
  })

  try {
    const client = await pool.connect()
    try {
      const result = await client.query('SELECT * FROM users WHERE active = true')
      return result.rows
    } finally {
      client.release()
    }
  } finally {
    await pool.end()
  }
}

queryDatabasePool()
  .then(rows => console.log(rows))
  .catch(err => console.error(err))

​
Crie um workflow para executar seu script

Seu workflow pode variar dependendo da linguagem escolhida e do caminho do arquivo do script que você criou.
1

Adicione um novo workflow

Navegue até a ferramenta Workflows e selecione Novo Workflow para adicionar um workflow. No campo Workflow, insira “testar conexão” como nome.
2

Crie um comando para executar o script

Selecione Executar Comando Shell sob o título Tarefas. Adicione um comando para executar o script que você criou na linha abaixo.A captura de tela a seguir mostra o workflow “testar conexão” configurado para executar um exemplo de conexão JavaScript:
captura de tela de um exemplo de workflow
3

Execute o workflow

Selecione a seta à esquerda do nome do workflow para executá-lo.
4

Veja a saída

Navegue até a ferramenta Console, onde você deve ver os dados da sua tabela users, se existirem.

​
Compartilhe um banco de dados entre múltiplos aplicativos Replit

Se você precisar que múltiplos aplicativos Replit compartilhem um único banco de dados, pode expô-lo como uma API REST. Essa abordagem permite que outros aplicativos ou serviços acessem e manipulem dados do banco de dados com segurança por meio de requisições HTTP padronizadas. Consulte o tutorial sobre compartilhamento de um banco de dados entre múltiplos aplicativos para um guia completo sobre como configurar um serviço de API de banco de dados seguro usando o template Database API Example.

​
Próximos passos

Para saber mais sobre como trabalhar com bancos de dados no Replit, consulte os seguintes recursos:
  • Banco de dados: aprenda como criar e gerenciar um banco de dados SQL usando a ferramenta Database do Replit.
  • Workflows: aprenda como criar e executar workflows personalizados.