As conexões são a maneira como aplicativos e bancos de dados podem se comunicar. Existem duas maneiras principais de fazer isso:
- Uma conexão externa faz uma viagem de ida e volta pela internet, portanto é muito mais lenta do que a comunicação interna. Nós recomendamos conexões externas se você estiver hospedando somente seu banco de dados conosco, mas não em seu frontend.
- Uma conexão interna fica dentro de nossa rede e, portanto, é muito mais rápida e mais segura. Recomendamos este método se você hospedar tanto seu frontend quanto seu banco de dados com a Hospedagem de Aplicativos e Hospedagem de Bancos de Dados.
Conexões externas
- Para aplicativos, conexões externas podem ser feitas por meio do servidor da web, como você esperaria.
- Para bancos de dados, fornecemos detalhes de conexão de banco de dados externos.
Nota: No futuro, as conexões externas serão desativadas por padrão para bancos de dados, e nós recomendaremos mantê-las desligadas quando não estiverem em uso por razões de segurança.
Conexões Internas
As conexões internas utilizam nossa infraestrutura interna para comunicação e, portanto, são muito mais rápidas. Nós recomendamos usá-las sempre que possível. Para mais detalhes, veja nosso guia sobre como Adicionar Conexões Internas.
Conexões internas e processo de build
Conexões internas estão disponíveis apenas durante a execução; elas não estão disponíveis durante o processo de build.
Se o seu aplicativo tentar se conectar a um banco de dados usando uma conexão interna durante o processo de build, isso causará um erro dizendo que o banco de dados não está em execução, o que fará com que a build falhe. Isso é esperado porque a conexão interna não está ativa durante a build; ela só pode ser usada durante a execução.
Existem algumas maneiras de contornar isso.
Opção 1: Mova a lógica que se conecta ao banco de dados do comando de build do aplicativo para o comando start. Por exemplo: se você tem um comando como prisma migrate
no processo de build, mova esse comando para o comando start. Assim, o seu aplicativo só acessará o banco de dados durante a execução, e a build será bem-sucedida.
Opção 2: Adicione variáveis de ambiente separadas conforme necessário para a conexão do banco de dados, uma disponível para o processo de build e outra apenas para a execução. As chaves podem ser as mesmas (por exemplo, DB_CONNECTION_URL
), desde que uma esteja disponível apenas durante o processo de build e a outra esteja disponível apenas durante a execução. Use os detalhes de conexão externa do banco de dados (Bancos de dados > nomedobanco > Informações > Conexões externas) para os valores de quaisquer variáveis a serem usadas no processo de build.
Remover uma Conexão Interna
Se você precisar remover uma conexão, vá para a página de Configurações do aplicativo ou para a página de Informações do banco de dados. Em Conexões internas, clique no ícone excluir (lixeira).

Na página Remover conexão modal/pop-up, clique em Remover conexão para confirmar e remover a conexão entre o aplicativo e o banco de dados.
