Todos os produtos
Search
Central de documentação

ApsaraDB RDS:Connect to an RDS for SQL Server instance

Última atualização: Jul 10, 2026

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:

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:

  1. 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.

  2. 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:

  1. 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.

  2. 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.

  1. Acesse a página Instances. Selecione a região na barra de navegação superior, encontre a instância e clique em respectivo ID.

  2. Clique em Log On to Database.

    image..png

  3. 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.

    image

  4. 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 image à direita para atualizar.

    image

  5. 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.

  1. Inicie o SSMS.

  2. Escolha Connect > Database Engine.

  3. 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,1433

    O 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

    testuser

    O nome de usuário da conta RDS.

    Password

    Test_pw123

    A senha da conta RDS.

  4. 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

Opção A: Adicionar a dependência Maven

Adicione o seguinte ao arquivo pom.xml do seu projeto Maven. Selecione a versão correspondente à sua versão do Java — por exemplo, mssql-jdbc-12.2.0.jre8.jar funciona com Java 8 ou posterior. Para versões anteriores, consulte o repositório oficial.

<dependency>
  <groupId>com.microsoft.sqlserver</groupId>
  <artifactId>mssql-jdbc</artifactId>
  <version>12.2.0.jre8</version>
</dependency>

Após adicionar a dependência, clique em ícone de atualização do Maven para baixá-la automaticamente.

image

image

image

Opção B: Baixar o driver manualmente

  1. Baixe o driver JDBC compatível com sua versão do Java em Baixar Microsoft JDBC Driver for SQL Server.

  2. Extraia o pacote e adicione o arquivo JAR (como sqljdbc4.jar ou sqljdbc.jar) ao classpath do seu projeto. As capturas de tela a seguir mostram como adicionar o JAR no IntelliJ IDEA.

    image

    image

    image

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>

Endpoint interno ou público da instância RDS

rm-2vc367d081200******.mssql.cn-chengdu.rds.aliyuncs.com

<port>

Número da porta

1433

<YourDatabaseName>

Nome do banco de dados de destino

mydb

<YourTableName>

Tabela a ser consultada

orders

<YourColumnName1>, <YourColumnName2>

Colunas a serem recuperadas

id, name

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!

image

Perguntas frequentes

Meu endereço IP público muda constantemente. Como manter o acesso pela lista de permissões?

Adicione o bloco CIDR que abrange seu intervalo de IPs à lista de permissões, em vez de um único IP. Para orientações, consulte Configurar uma lista de permissões de endereços IP e Como obtenho o endereço IP público de um servidor externo ou de um cliente?

Importante

0.0.0.0/0 permite acesso de qualquer endereço IP. Se você adicioná-lo temporariamente para testes, remova-o ou substitua-o imediatamente após o teste.

Como acesso minha instância RDS a partir do Function Compute?

Instale dependências de terceiros na sua função do Function Compute e use os módulos integrados fornecidos por essas dependências para consultar a instância. Consulte Instalar dependências de terceiros no Function Compute.

Fiz login com o DMS, mas meu banco de dados não aparece em Instances Connected. Por quê?

Há dois pontos a verificar: a conta de login pode não ter permissões para esse banco de dados ou os metadados do banco de dados podem não estar sincronizados. Acesse a página Accounts da instância RDS, localize a conta e clique em Change Permissions na coluna Actions para conceder acesso. Se as permissões estiverem corretas, passe o mouse sobre o nome da instância e clique em ícone image para atualizar os metadados do banco de dados.

Não consigo me conectar à minha instância RDS pelo computador usando o SSMS. O que devo verificar?

Certifique-se de ter solicitado um endpoint público para a instância — o endpoint interno não é acessível fora da rede interna da Alibaba Cloud. Não há cobrança pelo tráfego de Internet gerado ao solicitar o endpoint público nem pelo uso subsequente. Consulte Solicitar ou liberar um endpoint público.

image

Confirme também se o endereço IP público do seu computador consta na lista de permissões de endereços IP. Consulte Configurar uma lista de permissões de endereços IP.

image

Estou recebendo um erro de login no cliente DMS, mesmo com credenciais corretas.

Use o console web do DMS — conforme descrito na seção Conectar usando o DMS acima. Se ainda encontrar erros após mudar para o console web, consulte Perguntas frequentes sobre login em banco de dados usando o DMS.

Próximos passos