# Conectar-se à instância de banco de dados do MariaDB Depois que o Amazon RDS provisionar a sua instância de banco de dados, será possível usar qualquer utilitário ou aplicativo cliente MariaDB padrão para se conectar à instância. Na string de conexão, especifique o endereço DNS (Domain Name System) do endpoint da instância de banco de dados como o parâmetro de host. Especifique também o número da porta do endpoint da instância de banco de dados como o parâmetro da porta. É possível se conectar a uma instância de banco de dados do Amazon RDS para MariaDB usando ferramentas como o cliente MySQL de linha de comando. Para ter mais informações sobre como usar o cliente MySQL de linha de comando, consulte [mysql command-line client](http://mariadb.com/kb/en/mariadb/mysql-command-line-client/), na documentação do MariaDB. O Heidi é uma aplicação baseada em GUI que você pode usar para se conectar. Para ter mais informações, consulte a página [Download HeidiSQL](http://www.heidisql.com/download.php). Para obter informações sobre como instalar o MySQL (incluindo o cliente MySQL de linha de comando), consulte [Installing and upgrading MySQL](https://dev.mysql.com/doc/refman/8.0/en/installing.html) (Instalar e atualizar o MySQL). A maioria das distribuições do Linux inclui o cliente MariaDB em vez do cliente Oracle MySQL. Para instalar o cliente da linha de comando do MySQL no Amazon Linux 2023, execute o seguinte comando: ``` sudo dnf install mariadb105 ``` Para instalar o cliente da linha de comando do MySQL no Amazon Linux 2, execute o seguinte comando: ``` sudo yum install mariadb ``` Para instalar o cliente de linha de comando do MySQL na maioria das distribuições do Linux baseadas em DEB, execute o comando a seguir. ``` apt-get install mariadb-client ``` Para conferir a versão do cliente de linha de comando do MySQL, execute o comando a seguir: ``` mysql --version ``` Para ler a documentação da versão atual do cliente do MySQL, execute o comando a seguir. ``` man mysql ``` Para se conectar a uma instância de banco de dados de fora de uma nuvem privada virtual (VPC) baseada em Amazon VPC, a instância de banco de dados deve estar acessível publicamente. Além disso, o acesso deve ser concedido usando as regras de entrada do grupo de segurança da instância de banco de dados, e os outros requisitos devem ser atendidos. Para ter mais informações, consulte [Não é possível conectar-se à instância de banco de dados do Amazon RDS](CHAP_Troubleshooting.md#CHAP_Troubleshooting.Connecting). Você pode usar a criptografia SSL em conexões com uma instância de banco de dados MariaDB. Para ter mais informações, consulte [Suporte de SSL/TLS para instâncias de banco de dados do MariaDB no Amazon RDS](MariaDB.Concepts.SSLSupport.md). Para encontrar uma instância de banco de dados do RDS para MariaDB e conectar-se a ela, consulte os tópicos a seguir. **Topics** + [Localizar as informações de conexão para uma instância de banco de dados MariaDB](USER_ConnectToMariaDBInstance.EndpointAndPort.md) + [Conectar-se pelo cliente de linha de comandos do MySQL (descriptografado) para o RDS para MariaDB](USER_ConnectToMariaDBInstance.CLI.md) + [Conectar-se ao RDS para MariaDB com o driver JDBC da AWS e o driver Python da AWS](MariaDB.Connecting.Drivers.md) + [Solução de problemas de conexões da instância de banco de dados MariaDB](USER_ConnectToMariaDBInstance.Troubleshooting.md) # Localizar as informações de conexão para uma instância de banco de dados MariaDB As informações de conexão de uma instância de banco de dados incluem seu endpoint, porta e um usuário de banco de dados válido, como o usuário mestre. Por exemplo, suponha que um valor de endpoint seja `mydb.123456789012.us-east-1.rds.amazonaws.com`. Nesse caso, o valor da porta é `3306`, e o usuário do banco de dados é `admin`. Com essas informações, você especifica os seguintes valores em uma string de conexão: + Para o host, nome de host ou nome DNS, especifique `mydb.123456789012.us-east-1.rds.amazonaws.com`. + Para a porta, especifique `3306`. + Para usuário, especifique `admin`. Para se conectar a uma instância de banco de dados, use qualquer cliente para o mecanismo de banco de dados do MariaDB. Por exemplo, você pode usar o cliente MySQL de linha de comando ou o MySQL Workbench. Para localizar as informações de conexão de uma instância de banco de dados, você pode usar o Console de gerenciamento da AWS, comando da AWS Command Line Interface (AWS CLI) [describe-db-instances](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-instances.html) ou a operação da API do Amazon RDS [DescribeDBInstances](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBInstances.html) para listar seus detalhes. ## Console **Para encontrar as informações de conexão de uma instância de banco de dados no Console de gerenciamento da AWS** 1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon RDS em [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/). 1. No painel de navegação, escolha **Bancos de dados** para exibir uma lista de suas instâncias de banco de dados. 1. Escolha o nome da instância de banco de dados MariaDB para exibir os detalhes. 1. Na guia **Connectivity & security (Conectividade e segurança)**, copie o endpoint. Além disso, anote o número da porta. Você precisará do endpoint e do número da porta para conectar-se à instância de banco de dados. ![\[O endpoint e a porta de uma instância de banco de dados no console do Amazon RDS.\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/endpoint-port.png) 1. Se você precisar encontrar o nome de usuário mestre, escolha a guia **Configuração** e visualize o valor do nome de **usuário mestre** . ## AWS CLI Para localizar as informações de conexão de uma instância de banco de dados MariaDB usando o AWS CLI, execute o comando [describe-db-instances](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-instances.html). Na chamada, consulte o ID da instância de banco de dados, o endpoint, a porta e o nome de usuário mestre. Para Linux, macOS ou Unix: ``` aws rds describe-db-instances \ --filters "Name=engine,Values=mariadb" \ --query "*[].[DBInstanceIdentifier,Endpoint.Address,Endpoint.Port,MasterUsername]" ``` Para Windows: ``` aws rds describe-db-instances ^ --filters "Name=engine,Values=mariadb" ^ --query "*[].[DBInstanceIdentifier,Endpoint.Address,Endpoint.Port,MasterUsername]" ``` Sua saída deve ser similar à seguinte. ``` [ [ "mydb1", "mydb1.123456789012.us-east-1.rds.amazonaws.com", 3306, "admin" ], [ "mydb2", "mydb2.123456789012.us-east-1.rds.amazonaws.com", 3306, "admin" ] ] ``` ## API do RDS Para localizar as informações de conexão de uma instância de banco de dados usando a Amazon RDS API, chame a operação [DescribeDBInstances](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBInstances.html) . Na saída, encontre os valores para o endereço do endpoint, a porta do endpoint e o nome do usuário mestre. # Conectar-se pelo cliente de linha de comandos do MySQL (descriptografado) para o RDS para MariaDB **Importante** Use uma conexão MySQL não criptografada apenas quando o cliente e o servidor estiverem na mesma VPC e a rede for confiável. Para obter informações sobre como usar conexões criptografadas, consulte [Conectar-se à instância de banco de dados do MariaDB no Amazon RDS com SSL/TLS por meio do cliente de linha de comandos do MySQL (criptografado)](USER_ConnectToMariaDBInstanceSSL.CLI.md). Para se conectar a uma instância de banco de dados usando o cliente MySQL de linha de comando, insira o comando a seguir em um prompt de comando em um computador cliente. Isso conecta você a um banco de dados em uma instância de banco de dados MariaDB. Substitua o nome DNS (endpoint) da instância de banco de dados *``* e o nome de usuário mestre usado por *``*. Forneça a senha mestra usada quando for solicitada uma senha. ``` mysql -h -P 3306 -u -p ``` Depois de digitar a senha do usuário, você verá uma saída semelhante à seguinte. ``` Welcome to the MariaDB monitor. Commands end with ; or \g. Your MariaDB connection id is 31 Server version: 10.6.10-MariaDB-log Source distribution Copyright (c) 2000, 2018, Oracle, MariaDB Corporation Ab and others. Type 'help;' or '\h' for help. Type '\c' to clear the current input statement. MariaDB [(none)]> ``` # Conectar-se ao RDS para MariaDB com o driver JDBC da AWS e o driver Python da AWS Conecte-se a instâncias de banco de dados do RDS para MariaDB com o driver JDBC da AWS e o driver Python da AWS. Para obter mais informações, consulte os tópicos a seguir. **Topics** + [Conectar-se ao RDS para MariaDB com o driver JDBC da Amazon Web Services (AWS)](#MariaDB.Connecting.JDBCDriver) + [Conectar-se ao RDS para MariaDB com o driver Python da Amazon Web Services (AWS)](#MariaDB.Connecting.PythonDriver) ## Conectar-se ao RDS para MariaDB com o driver JDBC da Amazon Web Services (AWS) O driver JDBC da Amazon Web Services (AWS) foi projetado como um wrapper JDBC avançado. Esse wrapper é complementar e amplia a funcionalidade do driver JDBC existente. O driver é compatível de forma intercambiável com os drivers MySQL Connector/J e MariaDB Connector/J da comunidade. Para instalar o driver JDBC da AWS, anexe o arquivo .jar do driver JDBC da AWS (localizado na aplicação `CLASSPATH`) e mantenha referências ao respectivo driver da comunidade. Atualize o respectivo prefixo do URL de conexão da seguinte forma: + `jdbc:mysql://` para `jdbc:aws-wrapper:mysql://` + `jdbc:mariadb://` para `jdbc:aws-wrapper:mariadb://` Consulte mais informações sobre o driver JDBC da AWS e siga as instruções para usá-lo em [Amazon Web Services (AWS) JDBC Driver GitHub repository](https://github.com/awslabs/aws-advanced-jdbc-wrapper). ## Conectar-se ao RDS para MariaDB com o driver Python da Amazon Web Services (AWS) O driver Python da Amazon Web Services (AWS) foi projetado como um wrapper Python avançado. Esse wrapper é complementar e amplia a funcionalidade do driver Psycopg de código aberto. O driver Python da AWS é compatível com as versões 3.8 e posterior do Python. É possível instalar o pacote `aws-advanced-python-wrapper` usando o comando `pip`, bem como os pacotes de código aberto `psycopg`. Para ter mais informações sobre o driver Python da AWS e instruções completas para usá-lo, consulte [Amazon Web Services (AWS) Python Driver GitHub repository](https://github.com/awslabs/aws-advanced-python-wrapper). # Solução de problemas de conexões da instância de banco de dados MariaDB Duas causas comuns de falhas de conexão para uma nova instância de banco de dados são as seguintes: + A instância de banco de dados foi criada usando um grupo de segurança que não autoriza conexões do dispositivo ou da instância do Amazon EC2 em que o aplicativo ou utilitário do MariaDB está sendo executado. A instância de banco de dados deve ter um grupo de segurança de VPC que autorize as conexões. Para ter mais informações, consulte [Amazon VPC e Amazon RDS](USER_VPC.md). É possível adicionar ou editar uma regra de entrada no grupo de segurança. Em **Source (Origem)**, selecione **My IP (Meu IP)**. Isso concede acesso à instância de banco de dados do endereço IP detectado no navegador. + A instância de banco de dados foi criada usando a porta padrão 3306 e sua empresa emprega regras de firewall bloqueando conexões a essa porta a partir de dispositivos na rede de sua empresa. Para corrigir essa falha, recrie a instância com uma porta diferente. Para ter mais informações sobre problemas de conexão, consulte [Não é possível conectar-se à instância de banco de dados do Amazon RDS](CHAP_Troubleshooting.md#CHAP_Troubleshooting.Connecting).