# Como usar o editor de consultas do Aurora O editor de consultas do Aurora permite que você execute instruções SQL no cluster de banco de dados do Aurora por meio do Console de gerenciamento da AWS. É possível executar consultas SQL, instruções de manipulação de dados (DML) e instruções de definição de dados (DDL). O uso da interface do console permite que você realize a manutenção do banco de dados, gere relatórios e conduza experimentos de SQL. Você pode evitar definir a configuração de rede para se conectar ao cluster de banco de dados por um sistema cliente separado, como uma instância do EC2 ou um notebook. O editor de consultas exige um cluster de banco de dados do Aurora com a API de dados do RDS (API de dados) habilitada. Para ter informações sobre clusters de banco de dados que são compatíveis com a API de dados e como habilitá-la, consulte [Usar a API de dados do Amazon RDS](data-api.md). O SQL que você pode executar está sujeito às limitações da API de dados. Para obter mais informações, consulte [Limitações da API de dados do Amazon RDS](data-api.limitations.md). ## Disponibilidade do editor de consultas O editor de consultas está disponível para clusters de banco de dados do Aurora usando versões dos mecanismos do Aurora MySQL e do Aurora PostgreSQL compatíveis com a API de dados e as Regiões da AWS onde a API de dados está disponível. Para obter mais informações, consulte [Regiões e mecanismos de banco de dados do Aurora compatíveis com a API de dados do RDS](Concepts.Aurora_Fea_Regions_DB-eng.Feature.Data_API.md). ## Autorizar acesso ao editor de consultas Um usuário deve estar autorizado a executar consultas no editor. Você pode autorizar um usuário a executar consultas no editor de consultas adicionando a política `AmazonRDSDataFullAccess`, uma política predefinida do AWS Identity and Access Management (IAM), a esse usuário. **nota** Para criar o usuário do IAM, use o mesmo nome do usuário e senha utilizados para o usuário do banco de dados, como o nome de usuário administrativo e a senha. Para obter mais informações, consulte [Criar um usuário do IAM em sua Conta da AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users_create.html) no *Guia do usuário do AWS Identity and Access Management*. Também crie uma política do IAM que conceda acesso ao editor de consultas. Depois de criar a política, adicione-a a cada usuário que exija acesso ao editor de consultas. A política a seguir oferece as permissões obrigatórias mínimas para um usuário acessar o editor de consultas. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "QueryEditor0", "Effect": "Allow", "Action": [ "secretsmanager:GetSecretValue", "secretsmanager:PutResourcePolicy", "secretsmanager:PutSecretValue", "secretsmanager:DeleteSecret", "secretsmanager:DescribeSecret", "secretsmanager:TagResource" ], "Resource": "arn:aws:secretsmanager:*:*:secret:rds-db-credentials/*" }, { "Sid": "QueryEditor1", "Effect": "Allow", "Action": [ "secretsmanager:GetRandomPassword", "tag:GetResources", "secretsmanager:CreateSecret", "secretsmanager:ListSecrets", "dbqms:CreateFavoriteQuery", "dbqms:DescribeFavoriteQueries", "dbqms:UpdateFavoriteQuery", "dbqms:DeleteFavoriteQueries", "dbqms:GetQueryString", "dbqms:CreateQueryHistory", "dbqms:UpdateQueryHistory", "dbqms:DeleteQueryHistory", "dbqms:DescribeQueryHistory", "rds-data:BatchExecuteStatement", "rds-data:BeginTransaction", "rds-data:CommitTransaction", "rds-data:ExecuteStatement", "rds-data:RollbackTransaction" ], "Resource": "*" } ] } ``` ------ Para obter mais informações sobre como criar uma política do IAM, consulte [Criar políticas do IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html) no *Manual do usuário do AWS Identity and Access Management*. Para obter informações sobre como adicionar uma política do IAM a um usuário, consulte [Adicionar e remover permissões de identidade do IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-attach-detach.html) no *Manual do usuário do AWS Identity and Access Management*. ## Executar consultas no editor de consultas Execute declarações SQL em um cluster de banco de dados do Aurora no editor de consultas. O SQL que você pode executar está sujeito às limitações da API de dados. Para obter mais informações, consulte [Limitações da API de dados do Amazon RDS](data-api.limitations.md). **Para executar uma consulta no editor** 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 canto superior direito do Console de gerenciamento da AWS, selecione a Região da AWS na qual você criou os clusters de banco de dados do Aurora que deseja consultar. 1. No painel de navegação, escolha **Bancos de dados**. 1. Selecione o cluster de banco de dados do Aurora em que você deseja executar consultas SQL. 1. Em **Actions (Ações)**, escolha **Query (Consulta)**. Caso ainda não tenha se conectado ao banco de dados, a página **Connect to database (Conectar ao banco de dados)** é aberta. ![\[Página de conexão com o banco de dados do editor de consultas\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/AuroraUserGuide/images/query-editor-connect.png) 1. Insira as seguintes informações: 1. Em **Cluster ou instância de banco de dados**, selecione o cluster de banco de dados do Aurora no qual você deseja executar consultas SQL. 1. Em **Database username (Nome de usuário do banco de dados)**, escolha o nome do usuário do banco de dados para conexão ou escolha **Add new database credentials (Adicionar novas credenciais do banco de dados)**. Se você selecionar **Add new database credentials (Adicionar novas credenciais do banco de dados)**, insira o nome do usuário para as novas credenciais do banco de dados em **Enter database username (Inserir nome de usuário do banco de dados)**. 1. Em **Enter database password (Inserir senha do banco de dados)**, insira a senha do usuário do banco de dados escolhido. 1. Na última caixa, digite o nome do esquema ou banco de dados que você deseja usar no cluster de banco de dados Aurora. 1. Escolha **Connect to database (Conectar ao banco de dados)**. **nota** Caso a conexão seja bem-sucedida, as informações de conexão e autenticação são armazenadas no AWS Secrets Manager. Não é necessário digitar novamente as informações da conexão. 1. No editor de consultas, insira a consulta SQL que você deseja executar no banco de dados. ![\[Editor de Consultas com uma declaração SQL na área de texto\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/AuroraUserGuide/images/query-editor.png) Cada instrução SQL pode ser confirmada automaticamente ou você pode executar instruções SQL em um script como parte de uma transação. Para controlar esse comportamento, escolha o ícone de engrenagem acima da janela de consulta. ![\[Ícone de engrenagem no editor de consulta\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/AuroraUserGuide/images/query-editor-gear.png) A janela **Query Editor Settings (Configurações do editor de consultas)** é exibida. ![\[Configurações do editor de consulta\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/AuroraUserGuide/images/query-editor-settings.png) Se você selecionar **Auto-commit (Confirmar automaticamente)**, cada instrução SQL é confirmada automaticamente. Se você selecionar **Transação**, poderá executar um grupo de instruções em um script. As instruções são confirmadas automaticamente no final do script, a menos que explicitamente confirmadas ou revertidas antes disso. Além disso, você poderá optar por interromper a execução de um script se ocorrer um erro habilitando a opção **Stop on error (Interromper em caso de erro)**. **nota** Em um grupo de instruções, as instruções da linguagem de definição de dados (DDL) podem fazer com que as instruções da linguagem de manipulação de dados (DML) sejam confirmadas. Você também pode incluir instruções `COMMIT` e `ROLLBACK` em um grupo de instruções em um script. Após fazer suas escolhas na janela **Query Editor Settings (Configurações do editor de consultas)**, escolha **Save (Salvar)**. 1. Escolha **Run (Executar)** ou pressione Ctrl\$1Enter e o editor de consultas exibirá os resultados de sua consulta. Depois de executar a consulta, salve-a em **Saved queries (Consultas salvas)** selecionando **Save (Salvar)**. Exporte os resultados da consulta para o formato de planilha escolhendo **Export to csv (Exportar para csv)**. Você pode encontrar, editar e executar consultas anteriores novamente. Para isso, escolha a guia **Recent (Recente)** ou a guia **Saved queries (Consultas salvas)**, escolha o texto da consulta e escolha **Run (Executar)**. Para alterar o banco de dados, escolha **Change database (Alterar banco de dados)**. # Referência da API DBQMS (Database Query Metadata Service) O Database Query Metadata Service (`dbqms`) é um serviço somente interno. Ele fornece suas consultas recentes e salvas para o editor de consultas no Console de gerenciamento da AWS para vários produtos da AWS, inclusive o Amazon RDS . **Topics** + [CreateFavoriteQuery](#CreateFavoriteQuery) + [CreateQueryHistory](#CreateQueryHistory) + [CreateTab](#CreateTab) + [DeleteFavoriteQueries](#DeleteFavoriteQueries) + [DeleteQueryHistory](#DeleteQueryHistory) + [DeleteTab](#DeleteTab) + [DescribeFavoriteQueries](#DescribeFavoriteQueries) + [DescribeQueryHistory](#DescribeQueryHistory) + [DescribeTabs](#DescribeTabs) + [GetQueryString](#GetQueryString) + [UpdateFavoriteQuery](#UpdateFavoriteQuery) + [UpdateQueryHistory](#UpdateQueryHistory) + [UpdateTab](#UpdateTab) ## CreateFavoriteQuery Salva uma nova consulta como favorita. Cada usuário do pode criar até 1.000 consultas salvas. Este limite está sujeito a alterações no futuro. ## CreateQueryHistory Salve uma nova entrada de histórico de consultas. ## CreateTab Salve uma nova guia de consulta. Cada usuário do pode criar até 10 guias de consulta. ## DeleteFavoriteQueries Exclua uma ou mais consultas salvas. ## DeleteQueryHistory Exclua entradas do histórico de consultas. ## DeleteTab Exclua entradas da guia de consulta. ## DescribeFavoriteQueries Liste as consultas salvas criadas por um usuário em determinada conta. ## DescribeQueryHistory Liste entradas do histórico de consultas. ## DescribeTabs Liste guias de consulta criadas por um usuário em determinada conta. ## GetQueryString Recupere o texto completo da consulta a partir de um ID de consulta. ## UpdateFavoriteQuery Atualize a string de consulta, a descrição, o nome ou a data de validade. ## UpdateQueryHistory Atualize o status do histórico de consultas. ## UpdateTab Atualize o nome da guia de consulta e a string de consulta.