Após concluir a configuração inicial de uma instância ApsaraDB RDS for SQL Server, conecte-se a ela usando o Data Management (DMS), o SQL Server Management Studio (SSMS) ou o Java Database Connectivity (JDBC). Este tópico aborda os três métodos.
Pré-requisitos
Antes de começar, verifique se você tem:
Uma instância RDS SQL Server em execução. Consulte Criar uma instância ApsaraDB RDS for SQL Server
Um banco de dados e uma conta criados na instância. Consulte Criar contas e bancos de dados
Uma lista de permissões de endereços IP configurada para a instância. Consulte Configurar uma lista de permissões de endereços IP
Para conexões de rede interna a partir de uma instância Elastic Compute Service (ECS), a instância ECS e a instância RDS devem estar na mesma Virtual Private Cloud (VPC) e na mesma região. Além disso, o endereço IP privado da instância ECS deve constar na lista de permissões. Para conexões a partir de um dispositivo local, adicione o endereço IP público do dispositivo à lista de permissões.
Antes de conectar
Verifique os itens abaixo antes de iniciar qualquer método de conexão:
O endereço IP do seu cliente (instância ECS ou dispositivo local) está adicionado à lista de permissões de endereços IP da instância.
Para conexões via SSMS ou JDBC fora da rede interna da Alibaba Cloud, solicite um endpoint público para a instância.
Localizar seu endpoint
Todos os métodos de conexão exigem o endpoint e a porta da instância. Para encontrá-los:
Acesse a página Instances. Na barra de navegação superior, selecione a região onde a instância está localizada. Clique em ID da instância.
Na página de detalhes da instância, localize o endpoint e o número da porta. Para obter etapas detalhadas, consulte Visualizar e alterar endpoints e números de porta.
|
Tipo de endpoint |
Quando usar |
|
Endpoint interno |
Conexão a partir de uma instância ECS na mesma VPC e região |
|
Endpoint público |
Conexão a partir de um dispositivo local ou de fora da rede interna da Alibaba Cloud. Solicite um endpoint público caso ainda não tenha feito isso. Consulte Solicitar ou liberar um endpoint público. |
Conectar usando o DMS
O DMS é uma plataforma de gerenciamento de banco de dados baseada na web. Ele não exige instalação de cliente nem configuração manual de lista de permissões para a própria instância RDS.
Acesse a página Instances. Selecione a região na barra de navegação superior, encontre a instância e clique em respectivo ID.
-
Clique em Log On to Database.

-
Na caixa de diálogo Log on to Database Instance, configure os parâmetros de login e clique em Login.
Access Mode: Selecione Account + password login.
Database Account e Database Password: Insira as credenciais da sua conta. Este exemplo utiliza a conta privilegiada
testuser.Control Mode: Escolha Flexible Management para uso experimental. Este modo é gratuito. Os modos Stable Change e Security Collaboration oferecem mais recursos, mas geram custos.

-
No painel de navegação à esquerda do console DMS, escolha Database Instances > Instances Connected para visualizar seus bancos de dados. Neste exemplo, o banco de dados
dbtesté exibido. Clique duas vezes em um banco de dados para abri-lo.Se a instância existir, mas o banco de dados não estiver listado em Instances Connected , verifique o seguinte: - A conta de login não tem permissões para esse banco de dados. Acesse a página Accounts da instância RDS, localize a conta e clique em Change Permissions na coluna Actions para conceder as permissões necessárias . - Os metadados do banco de dados não estão sincronizados. Passe o mouse sobre o nome da instância RDS e clique em ícone
à direita para atualizar.
Execute consultas e gerencie dados na guia SQL Console.
Conectar usando o SSMS
O SSMS é um cliente GUI para gerenciar bancos de dados SQL Server. Ele oferece suporte a conexões com instâncias RDS, instâncias SQL Server locais e instâncias SQL Server em outras nuvens.
Antes de se conectar com o SSMS:
Baixe a versão mais recente do SSMS para garantir compatibilidade com todas as versões do SQL Server. Consulte Baixar o SQL Server Management Studio (SSMS).
Solicite um endpoint público e adicione seu endereço IP local à lista de permissões.
Este exemplo utiliza o SSMS 19.0.
Inicie o SSMS.
Escolha Connect > Database Engine.
-
Na caixa de diálogo Connect to Server, insira os seguintes parâmetros:
Parâmetro
Valor de exemplo
Descrição
Server name
rm-2ze****.rds.aliyuncs.com,1433O endpoint público e a porta, separados por vírgula (,). Consulte Localizar seu endpoint.
Authentication
SQL Server Authentication
O método de autenticação.
Username
testuserO nome de usuário da conta RDS.
Password
Test_pw123A senha da conta RDS.
Clique em Connect.
Após uma conexão bem-sucedida, a instância conectada e seus bancos de dados aparecem no painel esquerdo do SSMS.
Conectar usando Java (JDBC)
Use o JDBC para conectar programaticamente um aplicativo Java à instância RDS.
Adicione o endereço IP do ambiente onde o aplicativo é executado à lista de permissões de endereços IP da instância antes de se conectar. Consulte Configurar uma lista de permissões de endereços IP .
Etapa 1: Adicionar o driver JDBC
Etapa 2: Conectar com código de exemplo
Armazene as credenciais em variáveis de ambiente em vez de codificá-las diretamente. Substitua os espaços reservados na URL de conexão pelos seus valores reais. Para detalhes sobre endpoints, consulte Visualizar e alterar endpoints e números de porta.
Use o endpoint interno se o aplicativo for executado em uma instância ECS na mesma VPC da instância RDS.
Use o public endpoint se o aplicativo for executado em um dispositivo local ou em outro ambiente.
import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.SQLException;
import java.sql.Statement;
import java.sql.ResultSet;
public class SqlServerConnection {
public static void main(String[] args) {
// Replace <endpoint> and <port> with the internal or public endpoint of your RDS instance.
// Replace <YourDatabaseName> with the target database name.
String url = "jdbc:sqlserver://<endpoint>:<port>;"
+ "database=<YourDatabaseName>;"
+ "encrypt=true;"
+ "trustServerCertificate=true;"
+ "loginTimeout=30;";
// Load credentials from environment variables to avoid hardcoding sensitive information.
String username = System.getenv("RDS_USERNAME");
String password = System.getenv("RDS_PASSWORD");
Connection connection = null;
try {
// Load the JDBC driver.
Class.forName("com.microsoft.sqlserver.jdbc.SQLServerDriver");
// Establish the connection.
connection = DriverManager.getConnection(url, username, password);
System.out.println("Connection succeeded!");
// Execute a sample query. Replace <YourTableName> and column names with actual values.
Statement statement = connection.createStatement();
String sql = "SELECT TOP 10 * FROM <YourTableName>";
ResultSet resultSet = statement.executeQuery(sql);
while (resultSet.next()) {
System.out.println("Column 1: " + resultSet.getString("<YourColumnName1>"));
System.out.println("Column 2: " + resultSet.getString("<YourColumnName2>"));
}
resultSet.close();
statement.close();
} catch (ClassNotFoundException e) {
e.printStackTrace();
} catch (SQLException e) {
e.printStackTrace();
} finally {
if (connection != null) {
try {
connection.close();
} catch (SQLException e) {
e.printStackTrace();
}
}
}
}
}
Substitua os seguintes espaços reservados antes de executar o código:
|
Espaço reservado |
Descrição |
Exemplo |
|
|
Endpoint interno ou público da instância RDS |
|
|
|
Número da porta |
|
|
|
Nome do banco de dados de destino |
|
|
|
Tabela a ser consultada |
|
|
|
Colunas a serem recuperadas |
|
Defina as variáveis de ambiente antes de executar:
export RDS_USERNAME=<your-username>
export RDS_PASSWORD=<your-password>
Etapa 3: Verificar a conexão
Compile e execute SqlServerConnection.java. Se a configuração estiver correta, a saída exibirá:
Connection succeeded!







