As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá. # Solução de problemas do Amazon Quick Sight Use essas informações para ajudá-lo a diagnosticar e corrigir problemas comuns que você pode encontrar ao usar o Amazon Quick Sight. **nota** Precisa de mais ajuda? Você pode visitar a [comunidade de usuários do](https://answers.quicksight.aws.amazon.com/sn/index.html) Amazon Quick Sight ou os [AWS fóruns](https://forums.aws.amazon.com/). Veja também a [Biblioteca de Recursos do Quick Sight](https://aws.amazon.com/quicksight/resource-library/). **Topics** + [Resolvendo problemas e mensagens de erro do Amazon Quick Sight](#quicksight-errors) + [Problemas de conectividade ao usar o Amazon Athena com o Amazon Quick Sight](troubleshoot-athena.md) + [Problemas de conectividade da fonte de dados para o Amazon Quick Sight](troubleshoot-connect-to-datasources.md) + [Problemas de login com o Quick Sight](troubleshoot-login.md) + [Problemas visuais com o Quick Sight](visual-issues.md) ## Resolvendo problemas e mensagens de erro do Amazon Quick Sight Se você estiver com dificuldade ou receber uma mensagem de erro, há algumas maneiras de resolver o problema. Veja a seguir alguns recursos que podem ajudar: + Para erros que ocorreram durante a ingestão do conjunto de dados (importação de dados), consulte [Códigos de erro de ingestão do SPICE](errors-spice-ingestion.md). + Para dúvidas técnicas de usuários, acesse a [comunidade de usuários](https://answers.quicksight.aws.amazon.com/sn/index.html). + Para dúvidas de administradores, consulte os [fóruns da AWS](https://forums.aws.amazon.com/). + Se precisar de assistência mais personalizada, entre em contato com o AWS Support. Para fazer isso enquanto estiver conectado ao seu Conta da AWS, escolha **Support** no canto superior direito e escolha **Support Center**. # Problemas de conectividade ao usar o Amazon Athena com o Amazon Quick Sight A seguir, você encontrará informações sobre a solução de problemas que você pode encontrar ao usar o Amazon Athena com o Amazon Quick Sight. Antes de tentar solucionar qualquer outra coisa no Athena, certifique-se de que é possível se conectar ao Athena. Para obter informações sobre como solucionar problemas de conexão com o Athena, consulte [Não consigo me conectar ao Amazon Athena](troubleshoot-connect-athena.md). Se você conseguir se conectar, mas tiver outros problemas, pode ser útil executar sua consulta no console do Athena ([https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/home)) antes de adicioná-la ao Amazon Quick Sight. Para obter informações adicionais sobre como solucionar problemas, consulte [Solução de problemas](https://docs.aws.amazon.com/athena/latest/ug/troubleshooting.html) no *Guia do usuário do Athena*. **Topics** + [Coluna não encontrada ao usar o Athena com o Amazon Quick Sight](troubleshoot-athena-column-not-found.md) + [Dados inválidos ao usar o Athena com o Amazon Quick Sight](troubleshoot-athena-invalid-data.md) + [Tempo limite de consulta ao usar o Athena com o Amazon Quick Sight](troubleshoot-athena-query-timeout.md) + [O repositório de armazenamento não existe mais ao usar o Athena com o Amazon Quick Sight](troubleshoot-athena-missing-bucket.md) + [Tabela incompatível ao ser usada AWS Glue com o Athena no Amazon Quick Sight](troubleshoot-athena-glue-table-not-upgraded.md) + [Tabela não encontrada ao usar o Athena com o Amazon Quick Sight](troubleshoot-athena-table-not-found.md) + [Erros de grupo de trabalho e de saída ao usar o Athena com o Quick Sight](troubleshoot-athena-workgroup.md) # Coluna não encontrada ao usar o Athena com o Amazon Quick Sight Você poderá receber um erro “`column not found`” se as colunas em uma análise estiverem ausentes na fonte de dados do Athena. No Amazon Quick Sight, abra sua análise. Na guia **Visualizar**, escolha **Escolher conjunto de dados** e **Editar conjuntos de dados de análise**. Na tela **Conjuntos de dados nesta análise**, escolha **Editar** próximo ao seu conjunto de dados para atualizar o conjunto de dados. O Amazon Quick Sight armazena o esquema em cache por dois minutos. Portanto, pode demorar dois minutos até que as alterações mais recentes sejam exibidas. Para investigar como a coluna foi perdida em primeiro lugar, você pode acessar o console do Athena ([https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/home)) e verificar o histórico de consultas para encontrar as consultas que editaram a tabela. Se esse erro ocorreu quando você estava editando uma consulta SQL personalizada na pré-visualização, verifique o nome da coluna na consulta e procure se há outros erros de sintaxe. Por exemplo, verifique se o nome da coluna não está delimitado por aspas simples, que são reservadas para strings. Se o problema ainda persistir, verifique se suas tabelas, colunas e consultas estão em conformidade com os requisitos do Athena. Para obter mais informações, consulte [Nomes de tabelas, bancos de dados e colunas](https://docs.aws.amazon.com/athena/latest/ug/tables-databases-columns-names.html) e [Solução de problemas](https://docs.aws.amazon.com/athena/latest/ug/troubleshooting.html) no *Guia do usuário do Athena*. # Dados inválidos ao usar o Athena com o Amazon Quick Sight Um erro de dados inválidos pode ocorrer quando você usa qualquer operador ou função em um campo calculado. Para resolver isso, verifique se os dados na tabela são consistentes com o formato que você forneceu para a função. Por exemplo, suponha que você esteja usando a função `parseDate(expression, [‘format’], [‘time_zone’])` como **parseDate(date\$1column, ‘MM/dd/yyyy’)**. Nesse caso, todos os valores em `date_column` devem estar em conformidade com o formato `'MM/dd/yyyy'` (`’05/12/2016’`). Qualquer valor que não esteja no seguinte formato (**‘2016/12/05’**) pode causar um erro. # Tempo limite de consulta ao usar o Athena com o Amazon Quick Sight Se a consulta expirar, você pode tentar essas opções para resolver o problema. Se a falha foi gerada durante o trabalho em uma análise, lembre-se de que o tempo limite do Amazon Quick Sight para gerar qualquer imagem é de dois minutos. Se estiver usando uma consulta SQL personalizada, você poderá simplificar a consulta para otimizar o tempo de execução. Se você estiver no modo de consulta direta (sem usar o SPICE), tente importar os dados para o SPICE. No entanto, se a consulta exceder o tempo limite de 30 minutos do Athena, você poderá obter outro tempo limite ao importar dados para o SPICE. Para obter as informações mais atuais sobre os limites do Athena, consulte [Amazon Athena Limits](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html#amazon-athena-limits) na *Referência geral da AWS*. # O repositório de armazenamento não existe mais ao usar o Athena com o Amazon Quick Sight Use esta seção para ajudá-lo a resolver este erro: "**O bucket de preparação para este resultado da consulta não existe mais na fonte de dados subjacente.**" Quando você cria um conjunto de dados usando o Athena, o Amazon Quick Sight cria um bucket Amazon S3. Por padrão, esse bucket tem um nome semelhante a "`aws-athena-query-results--`". Se você remover esse bucket, uma falha poderá ocorrer na próxima consulta do Athena com um erro informando que o bucket de preparação não existe mais. Para corrigir esse erro, crie um novo bucket com o mesmo nome na Região da AWS correta. # Tabela incompatível ao ser usada AWS Glue com o Athena no Amazon Quick Sight Se você está recebendo erros ao usar AWS Glue tabelas no Athena com o Amazon Quick Sight, pode ser porque alguns metadados estão faltando. Siga estas etapas para descobrir se suas tabelas não têm o `TableType` atributo que o Amazon Quick Sight precisa para que o conector Athena funcione. Normalmente, os metadados dessas tabelas não foram migrados para o Catálogo de AWS Glue Dados. Para obter mais informações, consulte [Atualização para o catálogo AWS Glue de dados Step-by-Step](https://docs.aws.amazon.com/athena/latest/ug/glue-upgrade.html) no *Guia do AWS Glue desenvolvedor*. Se você não quiser migrar para o Catálogo de AWS Glue Dados no momento, você tem duas opções. Você pode recriar cada AWS Glue tabela por meio do AWS Glue Management Console. Ou você pode usar os AWS CLI scripts listados no procedimento a seguir para identificar e atualizar tabelas com `TableType` atributos ausentes. Se você preferir usar a CLI para fazer isso, use o procedimento a seguir para ajudá-lo a projetar seus scripts. **Usar a CLI para projetar scripts** 1. Use a CLI para saber quais AWS Glue tabelas não `TableType` têm atributos. ``` aws glue get-tables --database-name ; ``` Por exemplo, é possível executar o seguinte comando na CLI. ``` aws glue get-table --database-name "test_database" --name "table_missing_table_type" ``` Veja a seguir um exemplo de como é o resultado. É possível ver que a tabela `"table_missing_table_type"` não tem o atributo `TableType` declarado. ``` { "TableList": [ { "Retention": 0, "UpdateTime": 1522368588.0, "PartitionKeys": [ { "Name": "year", "Type": "string" }, { "Name": "month", "Type": "string" }, { "Name": "day", "Type": "string" } ], "LastAccessTime": 1513804142.0, "Owner": "owner", "Name": "table_missing_table_type", "Parameters": { "delimiter": ",", "compressionType": "none", "skip.header.line.count": "1", "sizeKey": "75", "averageRecordSize": "7", "classification": "csv", "objectCount": "1", "typeOfData": "file", "CrawlerSchemaDeserializerVersion": "1.0", "CrawlerSchemaSerializerVersion": "1.0", "UPDATED_BY_CRAWLER": "crawl_date_table", "recordCount": "9", "columnsOrdered": "true" }, "StorageDescriptor": { "OutputFormat": "org.apache.hadoop.hive.ql.io.HiveIgnoreKeyTextOutputFormat", "SortColumns": [], "StoredAsSubDirectories": false, "Columns": [ { "Name": "col1", "Type": "string" }, { "Name": "col2", "Type": "bigint" } ], "Location": "s3://myAthenatest/test_dataset/", "NumberOfBuckets": -1, "Parameters": { "delimiter": ",", "compressionType": "none", "skip.header.line.count": "1", "columnsOrdered": "true", "sizeKey": "75", "averageRecordSize": "7", "classification": "csv", "objectCount": "1", "typeOfData": "file", "CrawlerSchemaDeserializerVersion": "1.0", "CrawlerSchemaSerializerVersion": "1.0", "UPDATED_BY_CRAWLER": "crawl_date_table", "recordCount": "9" }, "Compressed": false, "BucketColumns": [], "InputFormat": "org.apache.hadoop.mapred.TextInputFormat", "SerdeInfo": { "Parameters": { "field.delim": "," }, "SerializationLibrary": "org.apache.hadoop.hive.serde2.lazy.LazySimpleSerDe" } } } ] } ``` 1. Edite a definição de tabela no editor para adicionar `"TableType": "EXTERNAL_TABLE"` à definição da tabela, conforme mostrado no exemplo a seguir. ``` { "Table": { "Retention": 0, "TableType": "EXTERNAL_TABLE", "PartitionKeys": [ { "Name": "year", "Type": "string" }, { "Name": "month", "Type": "string" }, { "Name": "day", "Type": "string" } ], "UpdateTime": 1522368588.0, "Name": "table_missing_table_type", "StorageDescriptor": { "BucketColumns": [], "SortColumns": [], "StoredAsSubDirectories": false, "OutputFormat": "org.apache.hadoop.hive.ql.io.HiveIgnoreKeyTextOutputFormat", "SerdeInfo": { "SerializationLibrary": "org.apache.hadoop.hive.serde2.lazy.LazySimpleSerDe", "Parameters": { "field.delim": "," } }, "Parameters": { "classification": "csv", "CrawlerSchemaSerializerVersion": "1.0", "UPDATED_BY_CRAWLER": "crawl_date_table", "columnsOrdered": "true", "averageRecordSize": "7", "objectCount": "1", "sizeKey": "75", "delimiter": ",", "compressionType": "none", "recordCount": "9", "CrawlerSchemaDeserializerVersion": "1.0", "typeOfData": "file", "skip.header.line.count": "1" }, "Columns": [ { "Name": "col1", "Type": "string" }, { "Name": "col2", "Type": "bigint" } ], "Compressed": false, "InputFormat": "org.apache.hadoop.mapred.TextInputFormat", "NumberOfBuckets": -1, "Location": "s3://myAthenatest/test_date_part/" }, "Owner": "owner", "Parameters": { "classification": "csv", "CrawlerSchemaSerializerVersion": "1.0", "UPDATED_BY_CRAWLER": "crawl_date_table", "columnsOrdered": "true", "averageRecordSize": "7", "objectCount": "1", "sizeKey": "75", "delimiter": ",", "compressionType": "none", "recordCount": "9", "CrawlerSchemaDeserializerVersion": "1.0", "typeOfData": "file", "skip.header.line.count": "1" }, "LastAccessTime": 1513804142.0 } } ``` 1. Você pode adaptar o script a seguir para atualizar a entrada da tabela, para que inclua o atributo `TableType`. ``` aws glue update-table --database-name --table-input ``` Por exemplo: ``` aws glue update-table --database-name test_database --table-input ' { "Retention": 0, "TableType": "EXTERNAL_TABLE", "PartitionKeys": [ { "Name": "year", "Type": "string" }, { "Name": "month", "Type": "string" }, { "Name": "day", "Type": "string" } ], "Name": "table_missing_table_type", "StorageDescriptor": { "BucketColumns": [], "SortColumns": [], "StoredAsSubDirectories": false, "OutputFormat": "org.apache.hadoop.hive.ql.io.HiveIgnoreKeyTextOutputFormat", "SerdeInfo": { "SerializationLibrary": "org.apache.hadoop.hive.serde2.lazy.LazySimpleSerDe", "Parameters": { "field.delim": "," } }, "Parameters": { "classification": "csv", "CrawlerSchemaSerializerVersion": "1.0", "UPDATED_BY_CRAWLER": "crawl_date_table", "columnsOrdered": "true", "averageRecordSize": "7", "objectCount": "1", "sizeKey": "75", "delimiter": ",", "compressionType": "none", "recordCount": "9", "CrawlerSchemaDeserializerVersion": "1.0", "typeOfData": "file", "skip.header.line.count": "1" }, "Columns": [ { "Name": "col1", "Type": "string" }, { "Name": "col2", "Type": "bigint" } ], "Compressed": false, "InputFormat": "org.apache.hadoop.mapred.TextInputFormat", "NumberOfBuckets": -1, "Location": "s3://myAthenatest/test_date_part/" }, "Owner": "owner", "Parameters": { "classification": "csv", "CrawlerSchemaSerializerVersion": "1.0", "UPDATED_BY_CRAWLER": "crawl_date_table", "columnsOrdered": "true", "averageRecordSize": "7", "objectCount": "1", "sizeKey": "75", "delimiter": ",", "compressionType": "none", "recordCount": "9", "CrawlerSchemaDeserializerVersion": "1.0", "typeOfData": "file", "skip.header.line.count": "1" }, "LastAccessTime": 1513804142.0 }' ``` # Tabela não encontrada ao usar o Athena com o Amazon Quick Sight Você poderá receber um erro “`table not found`” se as tabelas em uma análise estiverem ausentes na fonte de dados do Athena. No console do Athena ([https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/home)), verifique sua tabela no esquema correspondente. Você pode recriar a tabela no Athena e, em seguida, criar um novo conjunto de dados no Amazon Quick Sight nessa tabela. Para investigar como a tabela foi perdida, é possível usar o console do Athena para verificar o histórico de consultas. Fazer isso ajuda você a encontrar as consultas que descartaram a tabela. Se esse erro ocorreu quando você estava editando uma consulta SQL personalizada na pré-visualização, verifique o nome da tabela na consulta e procure se há outros erros de sintaxe. O Amazon Quick Sight não consegue inferir o esquema a partir da consulta. O esquema deve ser especificado na consulta. Por exemplo, na instrução a seguir funciona. ``` select from my_schema.my_table ``` A seguinte instrução falha porque está faltando o esquema. ``` select from my_table ``` Se o problema ainda persistir, verifique se suas tabelas, colunas e consultas estão em conformidade com os requisitos do Athena. Para obter mais informações, consulte [Nomes de tabelas, bancos de dados e colunas](https://docs.aws.amazon.com/athena/latest/ug/tables-databases-columns-names.html) e [Solução de problemas](https://docs.aws.amazon.com/athena/latest/ug/troubleshooting.html) no *Guia do usuário do Athena*. # Erros de grupo de trabalho e de saída ao usar o Athena com o Quick Sight Para verificar se os grupos de trabalho estão configurados corretamente, verifique as configurações a seguir: + **O grupo de trabalho do Athena associado à fonte de dados deve existir.** Para corrigir isso, você pode retornar às configurações da fonte de dados do Athena e escolher um grupo de trabalho diferente. Para obter mais informações, consulte [Configurar grupos de trabalho](https://docs.aws.amazon.com/athena/latest/ug/workgroups-procedure.html) no *Guia do usuário do Athena*. Outra solução é fazer com que o Conta da AWS administrador recrie o grupo de trabalho no console do Athena. + **O grupo de trabalho do Athena associado à fonte de dados deve estar habilitado.** Um Conta da AWS administrador precisa habilitar o grupo de trabalho no console do Athena. Abra o console do Athena usando este link direto:. [https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/home) Em seguida, escolha o grupo de trabalho apropriado no painel **Workgroup (Grupo de trabalho)** e visualize as configurações. Escolha **Habilitar grupo de trabalho**. + **Certifique-se de ter acesso ao local de saída do Amazon S3 associado ao grupo de trabalho do Athena.** Para conceder permissões ao Amazon Quick Sight para acessar o local de saída do S3, o administrador do Amazon Quick Sight pode editar **Segurança e Permissões** na QuickSight tela **Gerenciar**. + **O grupo de trabalho do Athena deve ter um local de saída do S3 associado.** Um Conta da AWS administrador precisa associar um bucket do S3 ao grupo de trabalho no console do Athena. Abra o console do Athena usando este link direto:. [https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/home) Em seguida, escolha o grupo de trabalho apropriado no painel **Workgroup (Grupo de trabalho)** e visualize as configurações. Defina o **Local do resultado da consulta**. # Problemas de conectividade da fonte de dados para o Amazon Quick Sight Use a seção a seguir para ajudar na solução de problemas de conexões com as fontes de dados. Antes de continuar, verifique se seu banco de dados está disponível no momento. Além disso, verifique se você tem as informações de conexão corretas e as credenciais válidas. **Topics** + [Não consigo me conectar, embora as opções de conexão com a fonte de dados pareçam corretas (SSL)](troubleshoot-connect-SSL.md) + [Não consigo me conectar ao Amazon Athena](troubleshoot-connect-athena.md) + [Não consigo me conectar ao Amazon S3](troubleshoot-connect-S3.md) + [Não consigo criar ou atualizar um conjunto de dados usando uma fonte de dados existente do Adobe Analytics](troubleshoot-connect-adobe-analytics.md) + [Preciso validar a conexão com a fonte de dados ou alterar as configurações da fonte de dados](troubleshoot-connect-validate.md) + [Não consigo me conectar ao MySQL (problemas com SSL e com a autorização)](troubleshoot-connect-mysql.md) + [Não consigo me conectar ao RDS](troubleshoot-connect-RDS.md) # Não consigo me conectar, embora as opções de conexão com a fonte de dados pareçam corretas (SSL) Podem ocorrer problemas de conexão quando o Secure Sockets Layer (SSL) estiver configurado incorretamente. Os sintomas podem incluir o seguinte: + Você pode se conectar ao seu banco de dados de outras maneiras ou de outros locais, exceto nesse caso. + Você pode se conectar a um banco de dados semelhante, mas não a este. Antes de continuar, descarte as seguintes circunstâncias: + Problemas com permissões + Problemas de disponibilidade + Um certificado inválido ou expirado + Um certificado autoassinado + Cadeia de certificados na ordem errada + Portas não habilitadas + Firewall bloqueando um endereço IP + Web Sockets são bloqueados + Uma nuvem privada virtual (VPC) ou um grupo de segurança não configurado corretamente. Para ajudar a encontrar problemas com SSL, você pode usar um verificador SSL online ou uma ferramenta como OpenSSL. As etapas a seguir mostram a solução de problemas de uma conexão na qual o SSL seja suspeito. O administrador deste exemplo já instalou OpenSSL. **Example** 1. O usuário tem problema para se conectar ao banco de dados. O usuário verifica se é possível conectar um banco de dados diferente em outra Região da AWS. Outras versões do mesmo banco de dados são verificadas e podem ser conectadas com facilidade. 1. O administrador revisa o problema e decide para verificar se os certificados estão funcionando corretamente. O administrador realiza uma pesquisa on-line e encontra um artigo sobre o uso do OpenSSL para solucionar problemas ou depurar conexões SSL. 1. Usando o OpenSSL, o administrador verifica a configuração SSL no terminal. ``` echo quit openssl s_client –connect :port ``` O resultado mostra que o certificado não está funcionando. ``` ... ... ... CONNECTED(00000003) 012345678901234:error:140770FC:SSL routines:SSL23_GET_SERVER_HELLO:unknown protocol:s23_clnt.c:782: --- no peer certificate available --- No client certificate CA names sent --- SSL handshake has read 7 bytes and written 278 bytes --- New, (NONE), Cipher is (NONE) Secure Renegotiation IS NOT supported SSL-Session: Protocol : TLSv1.2 Cipher : 0000 Session-ID: Session-ID-ctx: Master-Key: Key-Arg : None PSK identity: None PSK identity hint: None Start Time: 1497569068 Timeout : 300 (sec) Verify return code: 0 (ok) --- ``` 1. O administrador corrige o problema ao instalar o certificado SSL no servidor de banco de dados do usuário. Para obter mais detalhes sobre a solução neste exemplo, consulte [Como usar SSL/TLS para criptografar uma conexão com uma instância de banco de dados](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.SSL.html) no *Guia do usuário do Amazon RDS.* # Não consigo me conectar ao Amazon Athena | | | --- | |    Público-alvo: administradores do Amazon Quick  | Use esta seção para ajudar com a solução de problemas de conexão com o Athena. Se não conseguir se conectar ao Amazon Athena, você poderá receber um erro de permissões insuficientes ao executar uma consulta, mostrando que as permissões não estão configuradas. Para verificar se você pode conectar o Amazon Quick Sight ao Athena, verifique as seguintes configurações: + AWS permissões de recursos dentro do Amazon Quick Sight + AWS Identity and Access Management Políticas (IAM) + Local do Amazon S3 + Localização dos resultados de consulta + AWS KMS política de chaves (somente para conjuntos de dados criptografados) Para detalhes, veja o seguinte. Para obter informações sobre como solucionar outros problemas do Athena, consulte [Problemas de conectividade ao usar o Amazon Athena com o Amazon Quick Sight](troubleshoot-athena.md). ## Certifique-se de que você autorizou o Amazon Quick Sight a usar o Athena | | | --- | |    Público-alvo: administradores do Amazon Quick  | Use o procedimento a seguir para garantir que você autorizou com sucesso o Amazon Quick Sight a usar o Athena. As permissões para AWS recursos se aplicam a todos os usuários do Amazon Quick Sight. Para realizar essa ação, você deve ser administrador do Amazon Quick Sight. Para verificar se você tem acesso, verifique se você vê a QuickSight opção **Gerenciar** ao abrir o menu do seu perfil no canto superior direito. **Para autorizar o Amazon Quick Sight a acessar o Athena** 1. Escolha o nome do seu perfil (no canto superior direito). Escolha **Gerenciar o Quick Sight** e, em seguida, role para baixo até a seção **Permissões personalizadas**. 1. Escolha **AWS recursos e**, em seguida, escolha **Adicionar ou remover**. 1. Encontre o Athena na lista. Desmarque a caixa correspondente ao Athena e, em seguida, selecione-a novamente para habilitá-lo. Depois, escolha **Connect both (Conectar ambos**). 1. Escolha os buckets que você deseja acessar a partir do Amazon Quick Sight. As configurações dos buckets S3 que você acessa aqui são as mesmas que você acessa escolhendo Amazon S3 na lista de. Serviços da AWS Tenha cuidado para não desabilitar acidentalmente um bucket usado por outra pessoa. 1. Escolha **Concluir** para confirmar sua seleção. Como alternativa, escolha **Cancelar** para sair sem salvar. 1. Escolha **Atualizar** para salvar suas novas configurações para acesso ao Amazon Quick Sight Serviços da AWS. Como alternativa, escolha **Cancelar** para sair sem fazer alterações. 1. Certifique-se de estar usando o correto Região da AWS ao terminar. Se você precisou alterar o seu Região da AWS como parte da primeira etapa desse processo, altere-o novamente para o Região da AWS que estava usando antes. ## Certifique-se de que suas políticas do IAM concedam as permissões adequadas | | | --- | |    Público-alvo: administradores de sistemas  | Suas políticas AWS Identity and Access Management (IAM) devem conceder permissões para ações específicas. Seu perfil ou usuário do IAM deve ser capaz de realizar a leitura e a gravação da entrada e da saída dos buckets do S3 que o Athena usa para suas consultas. Se o conjunto de dados for criptografado, o usuário do IAM precisa ser um usuário-chave na política da AWS KMS chave especificada. **Para verificar se as políticas do IAM têm permissão para usar os buckets do S3 para sua consulta.** 1. Abra o console do IAM em [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/). 1. Localize o perfil ou o usuário do IAM que você está usando. Escolha o nome do usuário ou da função para ver as políticas associadas. 1. Verifique se a política tem as permissões adequadas. Escolha uma política que você deseja verificar e, em seguida, selecione **Editar política**. Use o editor visual, que é aberto por padrão. Caso o editor JSON esteja aberto, escolha a guia **Visual editor** (Editor visual). 1. Escolha a entrada do S3 na lista para ver o conteúdo. A política precisa conceder permissões para indicar, ler e gravar. Se o S3 não estiver na lista ou não tiver as permissões corretas, é possível adicioná-las aqui. Para ver exemplos de políticas do IAM que funcionam com o Quick Sight, consulte[Exemplos de políticas de IAM para Quick](iam-policy-examples.md). ## Certifique-se de que o usuário do IAM tenha read/write acesso à sua localização do S3 | | | --- | |    Público-alvo: administradores do Amazon Quick  | **Para acessar os dados do Athena a partir do Quick Sight, primeiro certifique-se de que o Athena e sua localização no S3 estejam autorizados na tela Gerenciar. QuickSight** Para obter mais informações, consulte [Certifique-se de que você autorizou o Amazon Quick Sight a usar o Athena](#troubleshoot-connect-athena-authorizing). Em seguida, verifique as permissões relevantes do IAM. O usuário do IAM para sua conexão com o Athena precisa read/write acessar o local para onde seus resultados vão no S3. Comece verificando se o usuário do IAM tem uma política anexada que [permite acesso ao Athena](https://docs.aws.amazon.com/athena/latest/ug/setting-up.html#attach-managed-policies-for-using-ate), como `AmazonAthenaFullAccess`. Deixe o Athena criar o bucket usando o nome que ele exige e, em seguida, adicione esse bucket à lista de buckets que QuickSight podem ser acessados. Se você alterar o local padrão do bucket de resultados (`aws-athena-query-results-*`), certifique-se de que o usuário do IAM tenha permissão para realizar leituras e gravações no novo local. Verifique se você não incluiu o Região da AWS código na URL do S3. Por exemplo, use `s3://awsexamplebucket/path` em vez de usar `s3://us-east-1.amazonaws.com/awsexamplebucket/path`. Usar o URL do S3 errado causará um erro `Access Denied`. Verifique também se as políticas do bucket e as listas de controle de acesso a objetos (ACLs) [permitem que o usuário do IAM acesse os objetos nos buckets](https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html). Se o usuário do IAM estiver em um local diferente Conta da AWS, consulte [Acesso entre contas no Guia](https://docs.aws.amazon.com/athena/latest/ug/cross-account-permissions.html) do usuário do *Amazon Athena*. Se o conjunto de dados estiver criptografado, verifique se o usuário do IAM é um usuário-chave na política da AWS KMS chave especificada. Você pode fazer isso no AWS KMS console em [https://console.aws.amazon.com/kms](https://console.aws.amazon.com/kms). **Definir permissões para o local dos resultados da consulta do Athena** 1. Abra o console do Athena em [https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/home). 1. Verifique se você selecionou o grupo de trabalho que deseja usar: + Examine a opção **Grupo de trabalho** na parte superior. Tem o formato **Grupo de trabalho: *group-name***. Se o nome do grupo for o que você deseja usar, pule para a próxima etapa. + Para escolher um grupo de trabalho diferente, selecione **Grupo de trabalho** na parte superior. Escolha o grupo de trabalho que deseja usar e clique em **Alternar grupo de trabalho**. 1. Escolha **Configurações** no canto superior direito. (Não é comum) Se você receber um erro informando que o grupo de trabalho não foi encontrado, siga estas etapas para corrigi-lo: 1. Ignore a mensagem de erro por enquanto e, em vez disso, encontre **Grupo de trabalho: *group-name*** na página **Configurações**. O nome do seu grupo de trabalho é um hiperlink. Abra-o. 1. Na ** página **Grupo de trabalho:**, escolha **Editar grupo de trabalho à esquerda**. Em seguida, feche a mensagem de erro. 1. Próximo ao **Local do resultado da consulta**, abra o seletor de local do S3 ao clicar no botão **Selecionar** que tem o ícone da pasta de arquivos. 1. Escolha a pequena seta no final do nome do local do S3 para o Athena. O nome deve começar com `aws-athena-query-results`. 1. (Opcional) Criptografe os resultados da consulta ao selecionar a caixa de seleção **Criptografar os resultados armazenados no S3**. 1. Escolha **Salvar** para confirmar suas escolhas. 1. Se o erro não reaparecer, retorne para **Configurações**. Ocasionalmente, o erro pode aparecer novamente. Nesse caso, execute as seguintes etapas: 1. Escolha o grupo de trabalho e, em seguida, selecione **Visualizar detalhes**. 1. (Opcional) Para preservar suas configurações, faça anotações ou faça uma captura de tela da configuração do grupo de trabalho. 1. Escolha **Create workgroup (Criar grupo de trabalho)**. 1. Substitua o grupo de trabalho por um novo. Configure o local do S3 e as opções de criptografia adequados. Anote o local do S3 porque você precisará dele posteriormente. 1. Escolha **Salvar** para continuar. 1. Quando você não precisar mais do grupo de trabalho original, desative-o. Certifique-se de ler atentamente o aviso que aparecerá, pois ele informará o que você perderá se optar por desativá-lo. 1. Se você não conseguiu isso com a solução de problemas apresentada na etapa anterior, escolha **Configurações** no canto superior direito e obtenha o valor do local do S3 mostrado como **Local do resultado da consulta**. 1. Se a opção **Criptografar os resultados da consulta** estiver habilitada, verifique se ela usa SSE-KMS ou CSE-KMS. Anote a chave. 1. Abra o console do S3 em [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/), abra o bucket correto e escolha a guia **Permissões**. 1. Verifique se o seu usuário do IAM tem acesso ao visualizar a **Política do bucket**. Se você gerenciar o acesso com ACLs, verifique se as listas de controle de acesso (ACLs) estão configuradas visualizando a **Lista de Controle de Acesso**. 1. Se seu conjunto de dados estiver criptografado (a opção **Criptografar resultados da consulta** está selecionada nas configurações do grupo de trabalho), certifique-se de que o usuário ou a função do IAM seja adicionado como usuário chave na política dessa AWS KMS chave. Você pode acessar AWS KMS as configurações em [https://console.aws.amazon.com/kms](https://console.aws.amazon.com/kms). **Conceder acesso ao bucket do S3 usado pelo Athena** 1. Abra o console do Amazon S3 em [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/). 1. Escolha o bucket do S3 usado pelo Athena no **Local do resultado da consulta**. 1. Na guia **Permissions** (Permissões), verifique as permissões. Para obter mais informações, consulte o artigo do AWS Support [Quando executo uma consulta do Athena, recebo o erro “Acesso negado”.](https://aws.amazon.com/premiumsupport/knowledge-center/access-denied-athena/) # Não consigo me conectar ao Amazon S3 Para se conectar ao Amazon S3 com êxito, certifique-se de configurar a autenticação e criar um arquivo de manifesto válido dentro do bucket que você está tentando acessar. Além disso, certifique-se de que o arquivo descrito pelo manifesto esteja disponível. Para verificar a autenticação, certifique-se de que você autorizou o Amazon Quick Sight a acessar a conta do S3. Não basta que você, o usuário, esteja autorizado. O Amazon Quick Sight deve ser autorizado separadamente. **Para autorizar o Amazon Quick Sight a acessar seu bucket do Amazon S3** 1. Na Região da AWS lista no canto superior direito, escolha a região Leste dos EUA (Norte da Virgínia). Você usa isso Região da AWS temporariamente enquanto edita as permissões da sua conta. 1. No Amazon Quick Sight, escolha o nome do seu perfil (canto superior direito). Escolha **Gerenciar o Quick Sight** e, em seguida, role para baixo até a seção **Permissões personalizadas**. 1. Escolha **AWS recursos** e escolha **Adicionar ou remover**. 1. Localize o Amazon S3 na lista. Escolha uma das seguintes ações para abrir a tela em que você pode escolher os buckets do S3: + Se a caixa de seleção estiver desmarcada, selecione a caixa de seleção ao lado de Amazon S3. + Se a caixa de seleção estiver marcada, escolha **Detalhes** e, em seguida, selecione **Selecionar buckets do S3**. 1. Escolha os buckets que você deseja acessar do Amazon Quick Sight. Em seguida, escolha **Selecionar**. 1. Selecione **Atualizar**. 1. Se você alterou o seu Região da AWS durante a primeira etapa desse processo, altere-o novamente para o Região da AWS que você deseja usar. É altamente recomendável verificar se seu arquivo manifesto é válido. Se o Amazon Quick Sight não conseguir analisar seu arquivo, ele exibirá uma mensagem de erro. A mensagem pode ser algo como “We can't parse the manifest file as valid JSON” ou “We can't connect to the S3 bucket”. **Para verificar o arquivo manifesto** 1. Abra seu arquivo manifesto. Você pode fazer isso diretamente do console do Amazon S3 em. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/) Navegue até o arquivo manifesto e escolha **Abrir**. 1. Certifique-se de que o URI ou URLs fornecido dentro do arquivo de manifesto indique o arquivo ou arquivos aos quais você deseja se conectar. 1. Verifique se seu arquivo manifesto está formado corretamente, se você utilizar um link para o arquivo manifesto em vez de fazer o upload do arquivo. O link não deve ter frases adicionais após a palavra `.json`. Você pode obter o link correto para um arquivo do S3, visualizando seu valor **Link** nos detalhes no console do S3. 1. Verifique se o conteúdo do arquivo manifesto é válido usando um validador JSON, como em [https://jsonlint.com](https://jsonlint.com). 1. Verifique as permissões no seu bucket ou arquivo. Em [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/), navegue até seu bucket do Amazon S3, escolha a guia **Permissões e adicione as permissões** apropriadas. Certifique-se de que as permissões estão no nível certo: no bucket ou nos arquivos. 1. Se você estiver usando o protocolo `s3://`, em vez de `https://`, verifique se você fazer referência direta ao seu bucket. Por exemplo, use *s3://awsexamplebucket/myfile.csv* em vez de *s3://s3-us-west-2.amazonaws.com/awsexamplebucket/myfile.csv*. Especificar duplamente o Amazon S3, ao usar `s3://` e também `s3-us-west-2.amazonaws.com`, causará um erro. Para obter mais informações sobre os arquivos de manifesto e como realizar a conexão com o Amazon S3, consulte [Formatos compatíveis para arquivos manifesto do Amazon S3](supported-manifest-file-format.md). Além disso, verifique se o conjunto de dados do Amazon S3 foi criado de acordo com as etapas em [Como criar um conjunto de dados usando arquivos do Amazon S3](create-a-data-set-s3.md). Se você usa o Athena para se conectar ao Amazon S3, consulte [Não consigo me conectar ao Amazon Athena](troubleshoot-connect-athena.md). # Não consigo criar ou atualizar um conjunto de dados usando uma fonte de dados existente do Adobe Analytics A partir de 1º de maio de 2022, o Quick Sight não oferece mais suporte às operações legadas OAuth e da versão 1.3 e da API SOAP no Adobe Analytics. Se você experienciar falhas ao tentar criar ou atualizar um conjunto de dados usando uma fonte de dados existente do Adobe Analytics, poderá ter um token de acesso obsoleto. **Solucionar falhas ao criar ou atualizar um conjunto de dados usando uma fonte de dados existente do Adobe Analytics** 1. Abra o Quick Sight e escolha **Dados** à esquerda. 1. Escolha **Novo** e depois **Conjunto de dados.** 1. Na página **Criar um conjunto** de dados, escolha a fonte de dados do Adobe Analytics que você deseja atualizar na lista de fontes de dados existentes. 1. Escolha **Editar fonte de dados**. 1. Na página **Editar fonte de dados do Adobe Analytics** que é aberta, escolha **Atualizar fonte de dados** para autorizar novamente a conexão do Adobe Analytics. 1. Tente recriar ou atualizar o conjunto de dados novamente. A criação ou a atualização do conjunto de dados deverá ocorrer com êxito. # Preciso validar a conexão com a fonte de dados ou alterar as configurações da fonte de dados Em alguns casos, pode ser necessário atualizar a fonte de dados ou, se ocorrer um erro de conexão, verificar as configurações. Nesse caso, execute as etapas apresentadas a seguir. **Validar a conexão com a fonte de dados** 1. Na página inicial do Quick Sight, escolha **Dados** à esquerda. 1. Escolha **Novo** e depois **Conjunto de dados.** 1. Você verá uma lista das fontes de dados existentes. 1. Escolha a fonte de dados que você deseja testar ou alterar. 1. Se a opção for oferecida, escolha **Edit/Preview data**. 1. Escolha **Validate connection**. 1. Faça as alterações desejadas e, em seguida, escolha **Atualizar fonte de dados**. # Não consigo me conectar ao MySQL (problemas com SSL e com a autorização) Para verificar alguns problemas de conexão comuns no MySQL, use as seguintes etapas. Este procedimento ajuda você a descobrir se habilitou SSL e concedeu direitos de uso. **Encontrar soluções para alguns problemas de conexão comuns no MySQL** 1. Verifique `/etc/my.cnf` para ter certeza de que o SSL está habilitado para o MySQL. 1. No MySQL, execute o seguinte comando. ``` show status like 'Ssl%'; ``` Se o SSL estiver funcionando, você verá resultados como os seguintes. ``` +--------------------------------+----------------------+ | Variable_name | Value | +--------------------------------+----------------------+ | Ssl_accept_renegotiates | 0 | | Ssl_accepts | 1 | | Ssl_callback_cache_hits | 0 | | Ssl_cipher | | | Ssl_cipher_list | | | Ssl_client_connects | 0 | | Ssl_connect_renegotiates | 0 | | Ssl_ctx_verify_depth | 18446744073709551615 | | Ssl_ctx_verify_mode | 5 | | Ssl_default_timeout | 0 | | Ssl_finished_accepts | 0 | | Ssl_finished_connects | 0 | | Ssl_session_cache_hits | 0 | | Ssl_session_cache_misses | 0 | | Ssl_session_cache_mode | SERVER | | Ssl_session_cache_overflows | 0 | | Ssl_session_cache_size | 128 | | Ssl_session_cache_timeouts | 0 | | Ssl_sessions_reused | 0 | | Ssl_used_session_cache_entries | 0 | | Ssl_verify_depth | 0 | | Ssl_verify_mode | 0 | | Ssl_version | | +--------------------------------+----------------------+ ``` Se o SSL estiver desativado, você verá resultados como os seguintes. ``` +--------------------------------+-------+ | Variable_name | Value | +--------------------------------+-------+ | Ssl_accept_renegotiates | 0 | | Ssl_accepts | 0 | | Ssl_callback_cache_hits | 0 | | Ssl_cipher | | | Ssl_cipher_list | | | Ssl_client_connects | 0 | | Ssl_connect_renegotiates | 0 | | Ssl_ctx_verify_depth | 0 | | Ssl_ctx_verify_mode | 0 | | Ssl_default_timeout | 0 | | Ssl_finished_accepts | 0 | | Ssl_finished_connects | 0 | | Ssl_session_cache_hits | 0 | | Ssl_session_cache_misses | 0 | | Ssl_session_cache_mode | NONE | | Ssl_session_cache_overflows | 0 | | Ssl_session_cache_size | 0 | | Ssl_session_cache_timeouts | 0 | | Ssl_sessions_reused | 0 | | Ssl_used_session_cache_entries | 0 | | Ssl_verify_depth | 0 | | Ssl_verify_mode | 0 | | Ssl_version | | +--------------------------------+-------+ ``` 1. Verifique se você instalou um certificado SSL suportado no servidor do banco de dados. 1. Conceda o uso ao usuário específico para se conectar usando SSL. ``` GRANT USAGE ON *.* TO 'encrypted_user'@'%' REQUIRE SSL; ``` **nota** O TLS 1.2 para conexões MySQL requer o MySQL versão 5.7.28 ou superior. Se seu servidor MySQL aplicar somente o TLS 1.2 (por exemplo,`tls_version = TLSv1.2`) e a versão do servidor estiver abaixo de 5.7.28, o handshake SSL falhará com um erro. `Communications link failure` Para resolver isso, atualize seu banco de dados MySQL ou Aurora MySQL para a versão 5.7.28 ou superior. Para mais detalhes sobre a solução neste exemplo, consulte: + [SSL Support for MySQL DB Instances](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_MySQL.html#MySQL.Concepts.SSLSupport.html) no *Guia do usuário do Amazon RDS*. + [Como usar SSL/TLS para criptografar uma conexão com uma instância de banco de dados](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.SSL.html) no *Guia do usuário do Amazon RDS*. + [Documentação do MySQL](https://dev.mysql.com/doc/refman/5.6/en/using-encrypted-connections.html) # Não consigo me conectar ao RDS Para obter detalhes sobre como solucionar problemas de conexões com o Amazon RDS, consulte [Como criar um conjunto de dados usando um banco de dados](create-a-database-data-set.md). Você também pode consultar a documentação do Amazon RDS sobre solução de problemas de conexões: [Não é possível conectar-se à instância de banco de dados do Amazon RDS](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_Troubleshooting.html#CHAP_Troubleshooting.Connecting)*.* # Problemas de login com o Quick Sight Use a seção a seguir para ajudá-lo a solucionar problemas de login e acesso com o console do Quick Sight. **Topics** + [Permissões insuficientes ao usar o Athena com o Amazon Quick Sight](troubleshoot-athena-insufficient-permissions.md) + [O Amazon Quick Sight não está funcionando no meu navegador](troubleshoot-browser.md) + [Como excluo minha conta do Amazon Quick Sight?](troubleshoot-delete-quicksight-account.md) + [As pessoas da minha organização recebem a mensagem “Login externo não autorizado” quando tentam acessar o Quick Sight](troubleshoot-webidentity-federation.md) + [Meu login de e-mail parou de funcionar](troubleshoot-email-login.md) # Permissões insuficientes ao usar o Athena com o Amazon Quick Sight Se você receber uma mensagem de erro informando que você tem permissões insuficientes, tente realizar as etapas apresentadas a seguir para resolver o problema. Você precisa ter permissões de administrador para solucionar esse problema. **Resolver um erro de permissões insuficientes** 1. Certifique-se de que o Amazon Quick Sight possa acessar os buckets do Amazon S3 usados pelo Athena: 1. Para fazer isso, escolha o nome do seu perfil (no canto superior direito). Escolha **Gerenciar o Quick Sight** e, em seguida, role para baixo até a seção **Permissões personalizadas**. 1. Escolha **AWS recursos e**, em seguida, escolha **Adicionar ou remover**. 1. Localize o Athena na lista. Desmarque a caixa de seleção correspondente ao Athena e, em seguida, selecione-a novamente para habilitá-lo. Escolha **Conecte ambos**. 1. Escolha os buckets que você deseja acessar a partir do Amazon Quick Sight. As configurações dos buckets S3 que você acessa aqui são as mesmas que você acessa escolhendo Amazon S3 na lista de. Serviços da AWS Tenha cuidado para não desabilitar acidentalmente um bucket usado por outra pessoa. 1. Escolha **Select (Selecionar)** para salvar seus buckets do S3. 1. Escolha **Atualizar** para salvar suas novas configurações para acesso ao Amazon Quick Sight Serviços da AWS. Como alternativa, escolha **Cancelar** para sair sem fazer alterações. 1. Se seu arquivo de dados estiver criptografado com uma AWS KMS chave, conceda permissões à função IAM do Amazon Quick Sight para descriptografar a chave. A maneira mais fácil de fazer isso é usar a AWS CLI. Você pode executar o comando [create-grant](https://docs.aws.amazon.com/cli/latest/reference/kms/create-grant.html) AWS CLI para fazer isso. ``` aws kms create-grant --key-id --grantee-principal --operations Decrypt ``` O Amazon Resource Name (ARN) para a função Amazon Quick Sight tem o formato `arn:aws:iam:::role/service-role/aws-quicksight-service-role-v` e pode ser acessado no console do IAM. Para localizar o ARN da chave do AWS KMS , use o console do S3. Acesse o bucket que contém seu arquivo de dados e escolha a guia **Overview (Visão geral)**. A chave está localizada perto de **KMS key ID** (ID da chave do KMS). Para conexões do Amazon Athena, Amazon S3 e Athena Query Federation, o Quick Sight usa a seguinte função do IAM por padrão: ``` arn:aws:iam::AWS-ACCOUNT-ID:role/service-role/aws-quicksight-s3-consumers-role-v0 ``` Se o não `aws-quicksight-s3-consumers-role-v0` estiver presente, o Quick Sight usa: ``` arn:aws:iam::AWS-ACCOUNT-ID:role/service-role/aws-quicksight-service-role-v0 ``` # O Amazon Quick Sight não está funcionando no meu navegador Se você não conseguir visualizar o Amazon Quick Sight corretamente no navegador Google Chrome, siga as etapas a seguir para corrigir o problema. **Para visualizar o Amazon Quick Sight em seu navegador Chrome** 1. Abra o Chrome e acesse `chrome://flags/#touch-events`. 1. Se a opção estiver definida como **Automática**, altere-a para **Desabilitada**. 1. Feche e abra novamente o Chrome. # Como excluo minha conta do Amazon Quick Sight? Em alguns casos, talvez seja necessário excluir sua conta do Amazon Quick Sight mesmo quando não conseguir acessar o Amazon Quick Sight para cancelar a assinatura. Se sim, faça login AWS e use o link a seguir para abrir [a tela de cancelamento de inscrição](https://us-east-1.quicksight.aws.amazon.com/sn/console/unsubscribe):`https://us-east-1.quicksight.aws.amazon.com/sn/console/unsubscribe`. Essa abordagem funciona independentemente do Regiões da AWS que você usa. Ele exclui todos os dados, análises, usuários do Amazon Quick Sight e administradores do Amazon Quick Sight. Caso tenha alguma dificuldade, entre em contato com o suporte. # As pessoas da minha organização recebem a mensagem “Login externo não autorizado” quando tentam acessar o Quick Sight | | | --- | |    Público-alvo: administradores do Amazon Quick  | Quando um indivíduo em sua organização está se federando no Quick Sight usando **AssumeRoleWithWebIdentity**, o Quick Sight mapeia um único usuário baseado em função para um único login externo. Em alguns casos, esse indivíduo pode ser autenticado por meio de um login externo (como o Amazon Cognito) que se difere do usuário mapeado originalmente. Nesse caso, eles não conseguem acessar o Quick Sight e recebem a seguinte mensagem de erro inesperada. O login externo usado para federação não é autorizado para o usuário do Quick Sight. Para saber mais sobre como solucionar esse problema, consulte as seguintes seções: + [Por que isso está acontecendo?](#troubleshoot-webidentity-federation-why) + [Como posso corrigir isso?](#troubleshoot-webidentity-federation-how) ## Por que isso está acontecendo? ### Você está usando um fluxo simplificado do Amazon Cognito Se você estiver usando o Amazon Cognito para se federar no Quick Sight, a configuração de login único (IAM Identity Center) pode usar a operação de `CognitoIdentityCredentials` API para assumir a função do Quick Sight. Esse método mapeia todos os usuários no pool de identidade do Amazon Cognito para um único usuário do Quick Sight e não é suportado pelo Quick Sight. Recomendamos usar a operação de API `AssumeRoleWithWebIdentity` em vez disso, pois ela especifica o nome da sessão do perfil. ### Você está usando usuários não autenticados do Amazon Cognito O Centro de Identidade do IAM para o Amazon Cognito está configurado para usuários não autenticados no banco de identidades do Amazon Cognito. A política de confiança da função Quick Sight é configurada como no exemplo a seguir. Essa configuração permite que um usuário temporário do Amazon Cognito assuma uma sessão de função mapeada para um usuário exclusivo do Quick Sight. Como as identidades não autenticadas são temporárias, elas não são suportadas pelo Quick Sight. Recomendamos que você não use essa configuração, que não é compatível com o Quick Sight. Para o Quick Sight, certifique-se de que o Amazon Cognito IAM Identity Center use usuários autenticados. ### Você excluiu e recriou um usuário do Amazon Cognito com os mesmos atributos de nome do usuário Nesse caso, o usuário associado do Amazon Cognito que está mapeado para o usuário do Quick Sight foi excluído e recriado. O usuário do Amazon Cognito recém-criado tem um assunto subjacente diferente. Dependendo de como o nome da sessão da função é mapeado para o usuário do Quick Sight, o nome da sessão pode corresponder ao mesmo usuário baseado na função do Quick Sight. Recomendamos que você remapeie o usuário do Quick Sight para o assunto de usuário atualizado do Amazon Cognito usando `UpdateUser` a operação de API. Para obter mais informações, consulte o [exemplo de UpdateUser API](#troubleshoot-webidentity-federation-solutions-updateuser) a seguir. ### Você está mapeando vários grupos de usuários do Amazon Cognito em diferentes Contas da AWS grupos de identidades e com o Quick Sight O mapeamento de vários grupos de usuários do Amazon Cognito de forma diferente Contas da AWS para um grupo de identidades e o Quick Sight não é compatível com o Quick Sight. ## Como posso corrigir isso? Você pode usar as operações públicas da API do Quick Sight para atualizar as informações de login externas dos seus usuários. Use as opções apresentadas a seguir para saber como fazer isso. ### Use RegisterUser para criar usuários com informações de login externas Se o provedor de login externo for o Amazon Cognito, use o código da CLI apresentado a seguir para criar usuários. ``` aws quicksight register-user --aws-account-id account-id --namespace namespace --email user-email --user-role user-role --identity-type IAM --iam-arn arn:aws:iam::account-id:role/cognito-associated-iam-role --session-name cognito-username --external-login-federation-provider-type COGNITO --external-login-id cognito-identity-id --region identity-region ``` O `external-login-id` deve ser o ID de identidade para o usuário do Amazon Cognito. O formato é `:`, conforme mostrado no exemplo a seguir. ``` aws quicksight register-user --aws-account-id 111222333 --namespace default --email cognito-user@amazon.com --user-role ADMIN --identity-type IAM --iam-arn arn:aws:iam::111222333:role/CognitoQuickSightRole --session-name cognito-user --external-login-federation-provider-type COGNITO --external-login-id us-east-1:12345678-1234-1234-abc1-a1b1234567 --region us-east-1 ``` Se o provedor de login externo for um provedor do OpenID Connect (OIDC) personalizado, use o código da CLI apresentado a seguir para criar usuários. ``` aws quicksight register-user --aws-account-id account-id --namespace namespace --email user-email --user-role user-role --identity-type IAM --iam-arn arn:aws:iam::account-id:role/identity-provider-associated-iam-role --session-name identity-username --external-login-federation-provider-type CUSTOM_OIDC --custom-federation-provider-url custom-identity-provider-url --external-login-id custom-provider-identity-id --region identity-region ``` Veja um exemplo do a seguir: ``` aws quicksight register-user --aws-account-id 111222333 --namespace default --email identity-user@amazon.com --user-role ADMIN --identity-type IAM --iam-arn arn:aws:iam::111222333:role/CustomIdentityQuickSightRole --session-name identity-user --external-login-federation-provider-type CUSTOM_OIDC --custom-federation-provider-url idp.us-east-1.amazonaws.com/us-east-1_ABCDE --external-login-id 12345678-1234-1234-abc1-a1b1234567 --region us-east-1 ``` Para saber mais sobre o uso `RegisterUser` na CLI, consulte [RegisterUser](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_RegisterUser.html)a *Amazon Quick API* Reference. ### Use DescribeUser para verificar as informações de login externas dos usuários Se um usuário for um usuário federado baseado em perfil de um provedor de login externo, use a operação de API `DescribeUser` para verificar as informações de login externo dele, conforme mostrado no código a seguir. ``` aws quicksight describe-user --aws-account-id account-id --namespace namespace --user-name identity-provider-associated-iam-role/identity-username --region identity-region ``` Veja um exemplo do a seguir: ``` aws quicksight describe-user --aws-account-id 111222333 --namespace default --user-name IdentityQuickSightRole/user --region us-west-2 ``` O resultado contém os campos de informações de login externo, se houver. Veja um exemplo a seguir. ``` { "Status": 200, "User": { "Arn": "arn:aws:quicksight:us-east-1:111222333:user-default-IdentityQuickSightRole-user", "UserName": "IdentityQuickSightRole-user", "Email": "user@amazon.com", "Role": "ADMIN", "IdentityType": "IAM", "Active": true, "PrincipalId": "federated-iam-AROAAAAAAAAAAAAAA:user", "ExternalLoginFederationProviderType": "COGNITO", "ExternalLoginFederationProviderUrl": "cognito-identity.amazonaws.com", "ExternalLoginId": "us-east-1:123abc-1234-123a-b123-12345678a" }, "RequestId": "12345678-1234-1234-abc1-a1b1234567" } ``` Para saber mais sobre o uso `DescribeUser` na CLI, consulte [DescribeUser](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_DescribeUser.html)a *Amazon Quick API* Reference. ### Use UpdateUser para atualizar as informações de login externas dos usuários Em alguns casos, você pode descobrir que as informações de login externo salvas para o usuário usando o resultado `DescribeUser` não estão corretas ou que as informações de login externo estão ausentes. Nesse caso, você pode usar a operação de API `UpdateUser` para atualizar as informações. Use os exemplos apresentados a seguir. Para os usuários do Amazon Cognito, use: ``` aws quicksight update-user --aws-account-id account-id --namespace namespace --user-name cognito-associated-iam-role/cognito-username --email user-email --role user-role --external-login-federation-provider-type COGNITO --external-login-id cognito-identity-id --region identity-region ``` Veja um exemplo do a seguir: ``` aws quicksight update-user --aws-account-id 111222333 --namespace default --user-name CognitoQuickSightRole/cognito-user --email cognito-user@amazon.com --role ADMIN --external-login-federation-provider-type COGNITO --external-login-id us-east-1:12345678-1234-1234-abc1-a1b1234567 --region us-west-2 ``` Para os usuários do provedor OIDC personalizado, use: ``` aws quicksight update-user --aws-account-id account-id --namespace namespace --user-name identity-provider-associated-iam-role/identity-username --email user-email --role user-role --external-login-federation-provider-type CUSTOM_OIDC --custom-federation-provider-url custom-identity-provider-url --external-login-id custom-provider-identity-id --region identity-region ``` Veja um exemplo do a seguir: ``` aws quicksight update-user --aws-account-id 111222333 --namespace default --user-name IdentityQuickSightRole/user --email user@amazon.com --role ADMIN --external-login-federation-provider-type CUSTOM_OIDC --custom-federation-provider-url idp.us-east-1.amazonaws.com/us-east-1_ABCDE --external-login-id 123abc-1234-123a-b123-12345678a --region us-west-2 ``` Caso deseje excluir as informações de login externo para o usuário, use `NONE` `external login federation provider type`. Use o comando da CLI apresentado a seguir para excluir as informações de login externo. ``` aws quicksight update-user --aws-account-id account-id --namespace namespace --user-name identity-provider-associated-iam-role/identity-username --email user-email --role user-role --external-login-federation-provider-type NONE --region identity-region ``` Veja um exemplo do a seguir: ``` aws quicksight update-user --aws-account-id 111222333 --namespace default --user-name CognitoQuickSightRole/cognito-user --email cognito-user@amazon.com --role ADMIN --external-login-federation-provider-type NONE --region us-west-2 ``` Para saber mais sobre o uso `UpdateUser` na CLI, consulte a [UpdateUser](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_UpdateUser.html)*Amazon Quick API* Reference. # Meu login de e-mail parou de funcionar Atualmente, os e-mails fazem distinção de maiúsculas e minúsculas. Se seu login não estiver funcionando, peça ao administrador para verificar se há uma combinação de letras maiúsculas e minúsculas. Use seu e-mail como inserido. # Problemas visuais com o Quick Sight Use as seções apresentadas a seguir para obter ajuda sobre como solucionar problemas relacionados aos elementos visuais e suas formatações. **Topics** + [Não consigo visualizar os elementos visuais](troubleshoot-adding-visuals.md) + [Recebo uma barra de comentários em meus documentos impressos](troubleshoot-printing-docs.md) + [Meus gráficos de mapas não mostram locais](troubleshoot-geocoding.md) + [Minha tabela dinâmica parou de funcionar](troubleshoot-pivot-tables.md) + [Meu visual não consegue encontrar colunas ausentes](troubleshooting-dataset-changed-columns.md) + [Meu visual não consegue encontrar a tabela de consulta](troubleshooting-dataset-changed-tables.md) + [Meu elemento visual não é atualizado após a alteração de um campo calculado](troubleshooting-visual-refresh.md) + [Os valores em um arquivo do Microsoft Excel com notação científica não são formatados corretamente no Quick Sight](troubleshooting-number-formatting.md) # Não consigo visualizar os elementos visuais Use a seção a seguir para obter ajuda sobre como solucionar problemas relacionados a elementos visuais ausentes. Antes de continuar, verifique se você ainda consegue acessar a fonte de dados. Se não for possível se conectar à fonte de dados, consulte [Problemas de conectividade da fonte de dados para o Amazon Quick Sight](troubleshoot-connect-to-datasources.md). + Se você estiver enfrentando problemas para adicionar um elemento visual para uma análise, tente o seguinte: + Verifique sua conectividade e confirme se você tem acesso a todos os domínios que o Quick Sight usa para acessar. Para ver uma lista de todos os usos do URLs Quick Sight, consulte [Domínios acessados pelo Quick Sight](https://docs.aws.amazon.com//quicksight/latest/developerguide/vpc-interface-endpoints.html#vpc-interface-endpoints-restrictvpc-interface-endpoints-supported-domains). + Verifique se você não está tentando adicionar mais objetos do que o permitido pela cota. O Amazon Quick Sight suporta até 30 conjuntos de dados em uma única análise, até 30 imagens em uma única planilha e um limite de 20 planilhas por análise. + Suponha que você esteja editando uma análise para uma fonte de dados selecionada e a conexão com a fonte de dados termine inesperadamente. O estado de erro resultante pode impedir futuras alterações na análise. Neste caso, não será possível adicionar mais elementos visuais à análise. Verifique esse estado. + Se os elementos visuais não carregarem, tente o seguinte: + Se você estiver usando uma rede corporativa, peça ajuda ao administrador da rede e verifique se as configurações do firewall da rede permitem o tráfego de `*.aws.amazon.com`, `amazonaws.com`, `wss://*.aws.amazon.com` e `cloudfront.net`. + Adicione exceções ao seu bloqueador de anúncios para `*.aws.amazon.com`, `amazonaws.com`, `wss://*.aws.amazon.com` e `cloudfront.net`. + Se você estiver usando um servidor de proxy, verifique se `*.quicksight.aws.amazon.com` e `cloudfront.net` foram adicionados à lista de domínios aprovados (a lista de permissões). # Recebo uma barra de comentários em meus documentos impressos O navegador algumas vezes imprime a barra de feedback de documentos em toda a página, bloqueando alguns conteúdos impressos. Para evitar esse problema, use o ícone de seta para expansão na parte inferior esquerda da tela (mostrado a seguir) para minimizar a barra de comentários. Em seguida, imprima o documento. ![\[\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/printing-docs.png) # Meus gráficos de mapas não mostram locais Para que o mapeamento automático, chamado de geocodificação, funcione em gráficos de mapas, certifique-se de que seus dados sejam preparados seguindo as regras específicas. Para obter ajuda com problemas geoespaciais, consulte [Solução de problemas geoespaciais](geospatial-troubleshooting.md). Para obter ajuda com a preparação de dados para gráficos geoespaciais, consulte [Como adicionar dados geoespaciais](geospatial-data-prep.md). # Minha tabela dinâmica parou de funcionar Se a sua tabela dinâmica exceder as limitações computacionais do banco de dados subjacente, isso geralmente será causado pela combinação de itens nas fontes de campos. Em outras palavras, isso é causado por uma combinação de linhas, colunas, métricas e cálculos de tabela. Para reduzir o nível de complexidade e o potencial de erros, simplifique a tabela dinâmica. Para obter mais informações, consulte [Práticas recomendadas para tabelas dinâmicas](pivot-table-best-practices.md). # Meu visual não consegue encontrar colunas ausentes Os visuais em minha análise não estão funcionando conforme o esperado. A mensagem de erro diz `"The column(s) used in this visual do not exist."` A causa mais comum desse erro é a alteração do esquema da fonte de dados. Por exemplo, é possível que o nome de uma coluna tenha sido alterado de `a_column` para `b_column`. Dependendo de como seu conjunto de dados acessa a fonte de dados, escolha uma das opções apresentadas a seguir. + Se o conjunto de dados for baseado em SQL personalizado, siga um ou mais destes procedimentos: + Edite o conjunto de dados. + Edite a instrução SQL. Por exemplo, se o nome da tabela tiver sido alterado de `a_column` para `b_column`, é possível atualizar a instrução do SQL para criar um alias: `SELECT b_column as a_column`. Ao usar o alias para manter o mesmo nome de campo no conjunto de dados, você evita a necessidade de adicionar a coluna aos seus visuais como uma nova entidade. Quando terminar, escolha **Salvar e visualizar**. + Se o conjunto de dados não for baseado em SQL personalizado, siga um ou mais destes procedimentos: + Edite o conjunto de dados. + Para campos que agora têm nomes diferentes, renomeie-os no conjunto de dados. É possível usar os nomes de campo do seu conjunto de dados original. Em seguida, abra a análise e adicione os campos renomeados aos elementos visuais afetados. Quando terminar, escolha **Salvar e visualizar**. # Meu visual não consegue encontrar a tabela de consulta Nesse caso, os elementos visuais da análise não estão funcionando conforme o esperado. A mensagem de erro diz `"Amazon Quick Sight can’t find the query table."` A causa mais comum desse erro é a alteração do esquema da fonte de dados. Por exemplo, é possível que o nome de uma tabela tenha sido alterado de `x_table` para `y_table`. Dependendo de como o conjunto de dados acessa a fonte de dados, escolha uma das opções apresentadas a seguir. + Se o conjunto de dados for baseado em SQL personalizado, siga um ou mais destes procedimentos: + Edite o conjunto de dados. + Edite a instrução SQL. Por exemplo, se o nome da tabela foi alterado de `x_table` para `y_table`, é possível atualizar a cláusula FROM na instrução do SQL para fazer referência à nova tabela. Quando terminar, escolha **Salvar e visualizar** e, em seguida, selecione cada elemento visual e adicione novamente os campos, conforme necessário. + Se o conjunto de dados não for baseado em SQL personalizado, faça o seguinte: 1. Crie um novo conjunto de dados usando a nova tabela, `y_table`, por exemplo. 1. Abra sua análise. 1. Substitua o conjunto de dados original pelo conjunto de dados recém-criado. Se não houver alterações na coluna, todos os visuais deverão funcionar depois que o conjunto de dados for substituído. Para obter mais informações, consulte [Substituir conjuntos de dados](replacing-data-sets.md). # Meu elemento visual não é atualizado após a alteração de um campo calculado Ao atualizar um campo calculado do qual muitos outros campos dependem, as entidades consumidoras podem não ser atualizadas conforme o esperado. Por exemplo, quando você atualiza um campo calculado usado por um campo que está sendo visualizado, o elemento visual não é atualizado conforme o esperado. Para resolver esse problema, atualize seu navegador da Internet. # Os valores em um arquivo do Microsoft Excel com notação científica não são formatados corretamente no Quick Sight Quando você se conecta a um arquivo do Microsoft Excel que tem uma coluna numérica que contém valores com notação científica, eles podem não ser formatados corretamente no Quick Sight. Por exemplo, o valor 1.59964E\$111, que na verdade é 159964032802, é formatado como 159964000000 no Quick Sight. Isso pode conduzir a uma análise incorreta. Para resolver esse problema, formate a coluna como `Text` no Microsoft Excel e, em seguida, carregue o arquivo no Quick Sight.