Uso de clientes para estabelecer conexões - : Central de Documentação do Alibaba Cloud

Caso prefira conectar-se à instância RDS pela porta do PostgreSQL, consulte Conectar-se a uma instância do ApsaraDB RDS for PostgreSQL.

Pré-requisitos

Uma instância RDS com o Babelfish ativado já foi criada. Para mais informações, consulte Ativar o Babelfish para uma instância do ApsaraDB RDS for PostgreSQL.
Uma conta do Babelfish está disponível. Para mais detalhes, veja Gerenciar contas do Babelfish.
A lista de permissões permite que o servidor onde o cliente está instalado acesse a instância RDS. Consulte Configurar uma lista de permissões de endereços IP para uma instância do ApsaraDB RDS for PostgreSQL para orientações.
Os endpoints e a porta TDS da instância RDS com Babelfish ativado foram obtidos. Siga as instruções em Visualizar os endpoints e a porta TDS.

Procedimento

Conexão à instância RDS via TSQL (FreeTDS)

Execute o comando abaixo para instalar o TSQL (FreeTDS). Este exemplo utiliza o CentOS 7.
```
sudo yum install -y freetds
```

Utilize o seguinte comando para se conectar à instância RDS:

tsql -S pgm-****.pg.rds.aliyuncs.com -p 1433 -U babelfish_user

A tabela a seguir detalha os parâmetros utilizados.

Parâmetro	Exemplo	Descrição
-S	pgm-****.pg.rds.aliyuncs.com	Endpoint usado na conexão com a instância RDS.
-p	1433	Número da porta TDS.
-U	babelfish_user	Nome de usuário da conta do Babelfish.

Realize uma consulta SQL simples. Consulte Operações comuns e descrição de compatibilidade para mais informações.
```
SELECT name FROM sys.databases;
GO
```

Conexão à instância RDS via sqlcmd

Baixe e instale o sqlcmd. Acesse Download and install sqlcmd na documentação oficial do SQL Server para obter instruções.

Estabeleça a conexão com a instância RDS executando o comando:

sqlcmd -S pgm-****.pg.rds.aliyuncs.com,1433 -U babelfish_user

Confira a descrição dos parâmetros na tabela abaixo.

Parâmetro

Exemplo

Descrição

-S

pgm-****.pg.rds.aliyuncs.com,1433

Endpoint e número de porta para conexão com a instância RDS.

O valor segue o formato Endpoint,Port number.

-U

babelfish_user

Nome de usuário da conta do Babelfish.

Execute uma consulta SQL básica. Veja Operações comuns e descrição de compatibilidade para detalhes adicionais.
```
SELECT name FROM sys.databases;
GO
```

Conexão à instância RDS via SSMS

Faça o download e a instalação do SSMS. Consulte Download SSMS na documentação oficial do SQL Server.
Abra o cliente SSMS. Na barra de menus, selecione File > New > Database Engine Query.

Preencha os parâmetros e clique em Connect.

Os parâmetros necessários estão descritos na tabela a seguir.

Parâmetro	Exemplo	Descrição
Server type	Database Engine	Valor fixo para este parâmetro.
Server name	pgm-****.pg.rds.aliyuncs.com,1433	Endpoint e número de porta para conexão com a instância RDS. O formato exigido é `Endpoint,Port number`.
Authentication	SQL Server Authentication	Este campo possui um valor predefinido.
Login	babelfish_user	Credenciais (nome de usuário e senha) da conta do Babelfish.
Password	babelfish_pwd

Nota

Se a mensagem de erro Specified case is not valid. (Micosoft.SqlServer.ConnectionInfo) aparecer durante a conexão, solucione o problema conforme descrito nas Perguntas frequentes.

Conexão à instância RDS via Azure Data Studio

Obtenha e instale o Azure Data Studio. Consulte Download and install Azure Data Studio na documentação oficial do SQL Server.

Nota
Os exemplos desta seção baseiam-se na versão 1.45.1 do Azure Data Studio.
Inicie o Azure Data Studio e clique em Create a connection.

Defina os parâmetros de conexão e clique em Connect.

Veja abaixo a explicação de cada parâmetro.

Parâmetro	Exemplo	Descrição
Connection type	Microsoft SQL Server	Opção obrigatória e imutável.
Server	pgm-****.pg.rds.aliyuncs.com,1433	Endereço do endpoint e porta para acessar a instância RDS. Utilize o padrão `Endpoint,Port number`.
Authentication type	SQL Login	Configuração fixa para autenticação.
User name	babelfish_user	Informe o nome de usuário e a senha da conta do Babelfish.
Password	babelfish_pwd	Informe o nome de usuário e a senha da conta do Babelfish.
Encrypt	Optional (False)	Mantenha o valor padrão deste parâmetro.

Perguntas frequentes

**Como proceder ao receber o erro the Specified case is not valid. ** (Micosoft.SqlServer.ConnectionInfo)?

Causa: O Babelfish não oferece compatibilidade total com todas as tabelas de sistema do SQL Server, impedindo a criação de conexões pelo Object Explorer.

Esse problema surge ao clicar em Connect e selecionar Database Engine na lista suspensa do Object Explorer, resultando no erro: Specified cast is not valid. (Microsoft.SqlServer.ConnectionInfo).

A mensagem retornada durante a tentativa de conexão é: Specified cast is not valid. (Microsoft.SqlServer.ConnectionInfo).
Solução: Crie a conexão acessando File > New > Database Engine Query na barra de menus. Consulte Conexão à instância RDS via SSMS para o passo a passo completo.

Como resolver o erro "An existing connection was forcibly closed by the remote host"?

A mensagem completa do erro é: A connection was successfully established with the server, but then an error occurred during the login process. (provider: TCP Provider, error: 0 - An existing connection was forcibly closed by the remote host.) (Microsoft SQL Server, Error: 10054).

Causa: Esse erro ocorre caso o banco de dados babelfish_db seja excluído. Como esse banco é inicializado na criação da instância, sua remoção causa danos irreversíveis e bloqueia novas conexões.
Solução: O banco de dados babelfish_db é essencial para o funcionamento do Babelfish. Se ele for removido, a instância ficará inutilizável. Nesse cenário, crie uma nova instância do ApsaraDB RDS for PostgreSQL com o Babelfish ativado e utilize o recurso de backup e restauração para recuperar seus dados. Para mais detalhes, consulte Restaurar dados do PostgreSQL.