Selecione suas preferências de cookies

Usamos cookies essenciais e ferramentas semelhantes que são necessárias para fornecer nosso site e serviços. Usamos cookies de desempenho para coletar estatísticas anônimas, para que possamos entender como os clientes usam nosso site e fazer as devidas melhorias. Cookies essenciais não podem ser desativados, mas você pode clicar em “Personalizar” ou “Recusar” para recusar cookies de desempenho.

Se você concordar, a AWS e terceiros aprovados também usarão cookies para fornecer recursos úteis do site, lembrar suas preferências e exibir conteúdo relevante, incluindo publicidade relevante. Para aceitar ou recusar todos os cookies não essenciais, clique em “Aceitar” ou “Recusar”. Para fazer escolhas mais detalhadas, clique em “Personalizar”.

Como criar padrões de parâmetros no Amazon QuickSight

Modo de foco
Como criar padrões de parâmetros no Amazon QuickSight - Amazon QuickSight

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

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

Use esta seção para saber mais sobre os tipos de padrões do parâmetro disponíveis e como configurar cada um deles.

Cada campo pode ter um parâmetro e um controle associados a ele. Quando alguém visualiza um painel ou um relatório por e-mail, qualquer controle de planilha que tenha um valor padrão estático configurado usa o padrão estático. O valor padrão pode alterar a forma como os dados são filtrados, a maneira como as ações personalizadas se comportam e quais textos são exibidos no título de uma planilha dinâmica. Os relatórios de e-mail também oferecem suporte a padrões dinâmicos.

O padrão mais simples é um padrão estático (imutável), que mostra o mesmo valor para todos os usuários. Como criador do painel, você escolhe o valor padrão. Esse valor não poderá ser alterado pelas pessoas que usam o painel. No entanto, as pessoas podem escolher quaisquer valores nos controles. Definir um padrão não alterará isso. Para restringir os valores que uma pessoa pode selecionar, considere usar a segurança por linha. Para ter mais informações, consulte Uso da segurança por linha com regras baseadas em usuários para restringir o acesso a um conjunto de dados.

Criar ou editar um valor padrão estático que se aplique à visualização do painel de todos os usuários
  1. Escolha o menu de contexto (v) pelo parâmetro que você deseja editar ou crie um novo parâmetro ao seguir as etapas em Configuração de parâmetros no Amazon QuickSight.

  2. Insira um valor em Valor padrão estático para definir um padrão estático.

Para exibir um padrão diferente com base em quem está visualizando o painel, crie um parâmetro padrão dinâmico (DDP, na sigla em inglês). O uso de padrões dinâmicos envolve determinada preparação para mapear as pessoas aos padrões atribuídos a elas. Primeiro, você precisa criar uma consulta ao banco de dados ou um arquivo de dados que contenha informações sobre as pessoas, os campos e os valores padrão a serem exibidos. Você adiciona isso a um conjunto de dados e, em seguida, adiciona o conjunto de dados à sua análise. A seguir, você encontrará procedimentos que podem ser usados ​​para coletar informações, criar o conjunto de dados e adicionar o padrão dinâmico ao parâmetro.

Use as seguintes diretrizes ao criar um conjunto de dados para valores padrão dinâmicos:

  • Recomendamos usar um único conjunto de dados que contenha todas as definições padrão dinâmicas para um agrupamento lógico de usuários ou de grupos. Se possível, mantenha as definições em uma única tabela ou em um único arquivo.

  • Também recomendamos que os campos no seu conjunto de dados tenham nomes que se assemelhem aos nomes dos campos na análise. Não são todos os campos do conjunto de dados que precisam fazer parte da análise, por exemplo, se você estiver usando o mesmo conjunto de dados para os padrões em vários painéis. Os campos podem estar em qualquer ordem.

  • Não recomendamos combinar nomes de usuários e de grupos na mesma coluna ou no mesmo conjunto de dados. Esse tipo de configuração é mais trabalhoso para manter e para solucionar problemas.

  • Se você usar um arquivo delimitado por vírgula para criar o conjunto de dados, certifique-se de remover qualquer espaço entre os valores no arquivo. O exemplo apresentado a seguir mostra o formato correto para valores separados por vírgulas (CSV, na sigla em inglês). Delimite textos (strings) que incluam caracteres não alfanuméricos, como espaços, apóstrofos e assim por diante, entre aspas simples ou duplas. É possível delimitar campos que sejam datas ou horas entre aspas, mas isso não é obrigatório. Você pode delimitar campos numéricos entre aspas, por exemplo, se os números contiverem caracteres especiais, conforme mostrado a seguir.

    "Value includes spaces","Field contains ' other characters",12345.6789,"20200808" ValueWithoutSpaces,"1000,67","Value 3",2020-AUG-08
  • Após criar o conjunto de dados, certifique-se de verificar novamente os tipos de dados que o QuickSight seleciona para os campos.

Antes de começar, você precisa de uma lista de nomes de usuários ou de grupos para as pessoas que terão padrões dinâmicos. Para gerar uma lista de usuários ou de grupos, é possível usar a AWS CLI para obter as informações. Para executar comandos da CLI, certifique-se de ter a AWS CLI instalada e configurada. Para obter mais informações, consulte Instalar a AWS CLI no Guia do usuário da AWS CLI.

Este é apenas um exemplo de como obter uma lista de nomes de usuários ou de grupos. Use o método que funcionar melhor para você.

Identificar pessoas para um parâmetro padrão dinâmico (DDP)
  • Liste nomes de usuários individuais ou nomes de grupos:

    • Para listar nomes de usuários individuais, inclua uma coluna que identifique as pessoas para seu DDP. Esta coluna deve conter o nome do usuário do sistema que cada pessoa usa para se conectar do seu provedor de identidades ao QuickSight. Geralmente, esse nome do usuário é semelhante ao alias antes do símbolo de @ do e-mail de uma pessoa, mas isso não é regra.

      Para obter uma lista de usuários, use a operação de API ListUsers ou o comando da AWS CLI para o QuickSight. O comando da CLI é mostrado no exemplo a seguir. Especifique a Região da AWS para seu provedor de identidades, por exemplo, us-east-1.

      awsacct1="111111111111" namespace="default" region="us-east-1" aws quicksight list-users --aws-account-id $awsacct1 --namespace $namespace --region $region

      O exemplo a seguir altera o comando anterior ao adicionar uma consulta que limita os resultados aos usuários ativos.

      awsacct1="111111111111" namespace="default" region="us-east-1" aws quicksight list-users --aws-account-id $awsacct1 --namespace $namespace --region $region --query 'UserList[?Active==`true`]'

      O conjunto de resultados deve ser semelhante ao exemplo a seguir. Este exemplo é um trecho da saída em JSON (--output json). As pessoas que têm nomes de usuários federados têm IDs de entidades principais que começam com a palavra federated.

      [ { "Arn": "arn:aws:quicksight:us-east-1:111111111111:user/default/anacasilva", "UserName": "anacarolinasilva", "Email": "anacasilva@example.com", "Role": "ADMIN", "Active": true, "PrincipalId": "federated/iam/AIDAJ64EIEIOPX5CEIEIO" }, { "Arn": "arn:aws:quicksight:us-east-1:111111111111:user/default/Reader/liujie-stargate", "UserName": "Reader/liujie-stargate", "Role": "READER", "Active": true, "PrincipalId": "federated/iam/AROAIJSEIEIOMXTZEIEIO:liujie-stargate" }, { "Arn": "arn:aws:quicksight:us-east-1:111111111111:user/default/embedding/cxoportal", "UserName": "embedding/cxoportal", "Email": "saanvisarkar@example.com", "Role": "AUTHOR", "Active": true, "PrincipalId": "federated/iam/AROAJTGEIEIOWB6BEIEIO:cxoportal" }, { "Arn": "arn:aws:quicksight:us-east-1:111111111111:user/default/zhangwei@example.com", "UserName": "zhangwei@example.com", "Email": "zhangwei@example.com", "Role": "AUTHOR", "Active": true, "PrincipalId": "user/d-96123-example-id-1123" } ]
    • Para listar nomes de grupos, inclua uma coluna que identifique os grupos que contêm os nomes de usuários para seu DDP. Esta coluna deve conter os nomes dos grupos do sistema que são usados ​​para conectar seu provedor de identidades ao QuickSight. Para identificar grupos que você pode adicionar ao conjunto de dados, use uma ou mais das seguintes operações de API ou comandos da CLI para o QuickSight:

      • ListGroups: lista os grupos do QuickSight por ID da Conta da AWS e por namespace para a Região da AWS que contém seu provedor de identidades.

      • ListGroupMemberships: lista os usuários no grupo do QuickSight especificado.

      • ListUserGroups: lista os grupos do QuickSight dos quais um usuário do QuickSight é membro.

      Como alternativa, é possível pedir ao administrador da rede que consulte o provedor de identidades para obter essas informações.

Os próximos dois procedimentos fornecem instruções sobre como concluir a criação de um conjunto de dados para valores padrão dinâmicos. O primeiro procedimento é a criação de um conjunto de dados para um DDP de valor único. O segundo procedimento é a criação de um conjunto de dados para um DDP de vários valores.

Criar um conjunto de dados para um DDP de valor único
  1. Crie colunas de conjunto de dados com parâmetros de valor único. A primeira coluna na consulta ou no arquivo deve ser para as pessoas que usam o painel. Este campo pode conter nomes de usuários ou nomes de grupos. No entanto, o suporte para grupos está disponível somente na edição Enterprise do QuickSight.

  2. Em cada campo que exibe um padrão dinâmico para um parâmetro de valor único, adicione uma coluna ao conjunto de dados. O nome da coluna não importa, portanto, você pode usar o mesmo nome do campo ou do parâmetro.

    Os parâmetros de valor único funcionarão, conforme especificado, somente se a combinação entre a entidade utilizadora e o padrão dinâmico for exclusiva para o campo desse parâmetro. Se houver vários valores em um campo padrão para uma entidade utilizadora, o controle de valor único desse campo exibirá o padrão estático em vez disso. Se nenhum padrão estático for definido, o controle não exibirá um valor padrão. Tenha cuidado ao usar nomes de grupos, pois alguns nomes de usuários podem ser membros de diversos grupos. Se esses grupos tiverem valores padrão diferentes, esse tipo de nome do usuário funcionará como uma entrada duplicada.

    O exemplo apresentado a seguir mostra uma tabela que parece conter dois parâmetros de valor único. Fazemos essa suposição porque nenhum nome do usuário está associado a vários valores padrão. Para facilitar a compreensão desta tabela, adicionamos a palavra 'default' antes dos nomes dos campos da análise. Dessa maneira, é possível realizar a leitura da tabela fazendo a seguinte afirmação ao alterar os valores de cada linha: quando visualizados por anacarolinasilva, os controles apresentam uma região padrão NorthEast e um segmento padrão SMB.

    Visualizado por Região padrão Segmento padrão
    anacarolinasilva NorthEast SMB
    liujie SouthEast SMB
    saanvisarkar NorthCentral SMB
    zhangwei SouthCentral SMB
  3. Importe esses dados para o QuickSight e salve-os como um novo conjunto de dados.

  4. Na sua análise, adicione o conjunto de dados que você criou. A análise precisa usar, no mínimo, outro conjunto de dados que corresponda às colunas definidas para os padrões. Para ter mais informações, consulte Como adicionar um conjunto de dados a uma análise.

Criar um conjunto de dados para um DDP de vários valores
  1. Crie colunas de conjunto de dados com parâmetros de vários valores. A primeira coluna na consulta ou no arquivo deve ser para as pessoas que usam o painel. Este campo pode conter nomes de usuários ou nomes de grupos. No entanto, o suporte para grupos está disponível somente na edição Enterprise do QuickSight.

  2. Em cada campo que exibe um padrão dinâmico para um parâmetro de vários valores, adicione uma coluna ao conjunto de dados. O nome da coluna não importa, portanto, você pode usar o mesmo nome do campo ou do parâmetro.

    Ao contrário dos parâmetros de valor único, os parâmetros de vários valores permitem vários valores no campo associado ao parâmetro.

    O exemplo apresentado a seguir mostra uma tabela que parece conter um parâmetro de valor único e um parâmetro de vários valores. Podemos fazer essa suposição porque cada nome do usuário tem um valor exclusivo em uma coluna e alguns nomes de usuários têm vários valores na outra coluna. Para facilitar a compreensão desta tabela, adicionamos a palavra 'default' antes dos nomes dos campos da análise. Dessa maneira, é possível realizar a leitura da tabela fazendo a seguinte afirmação ao alterar os valores de cada linha: quando viewed-by for liujie, os controles apresentam um valor de default-region como SouthEast e um valor de default-city como Atlanta. Se lermos mais uma linha, veremos que liujie também tem Raleigh como default-city.

    Visualizado por Região padrão Cidade padrão
    anacarolinasilva NorthEast Nova York
    liujie SouthEast Atlanta
    liujie SouthEast Raleigh
    saanvisarkar NorthCentral Chicago
    zhangwei SouthCentral Dallas
    zhangwei SouthCentral Cidade de Kansas

    Neste exemplo, o parâmetro ao qual aplicamos default-region funciona corretamente, seja ele um parâmetro de valor único ou de vários valores. Se for um parâmetro de valor único, duas entradas funcionarão para um usuário porque ambas as entradas têm o mesmo valor, SouthEast. Se for um parâmetro de vários valores, ele ainda funcionará, exceto que somente um valor será selecionado por padrão. No entanto, se alterarmos o parâmetro que usa default-city como padrão de um parâmetro de vários valores para um parâmetro de valor único, não veremos esses padrões selecionados. Em vez disso, o parâmetro usará o padrão estático, se ele estiver definido. Por exemplo, se o padrão estático estiver definido como Atlanta, liujie terá Atlanta selecionada nesse controle, mas não Raleigh.

    Em alguns casos, seu valor padrão estático também pode ser usado como um padrão dinâmico. Nesse caso, certifique-se de testar o controle para um nome do usuário que não usa um valor padrão e que pode ser ambos.

    Se um nome do usuário pertencer a vários grupos, o usuário nomeado visualizará um conjunto de valores padrão que corresponde a uma união dos valores padrão dos dois grupos.

  3. Importe esses dados para o QuickSight e salve-os como um novo conjunto de dados.

  4. Na sua análise, adicione o conjunto de dados que você criou. A análise precisa usar, no mínimo, outro conjunto de dados que corresponda às colunas definidas para os padrões. Para ter mais informações, consulte Como adicionar um conjunto de dados a uma análise.

Use o procedimento apresentado a seguir para adicionar um parâmetro padrão dinâmico à sua análise. Antes de começar, certifique-se de ter um conjunto de dados que contenha os padrões dinâmicos para cada nome do usuário ou nome de grupo. Certifique-se também de que sua análise esteja usando este conjunto de dados. Para obter ajuda com relação a esses requisitos, consulte os procedimentos anteriores.

Adicionar um DDP à sua análise
  1. No console do QuickSight, selecione o ícone Parâmetros Vertical lines representing network connections between different components. na parte superior da página e escolha um parâmetro existente. Escolha Editar parâmetro no menu do parâmetro. Para adicionar um novo parâmetro, escolha o sinal de mais (+) próximo a Parâmetros.

  2. Escolha Set a dynamic default (Definir padrão dinâmico).

  3. Configure as seguintes opções com suas configurações:

    • Conjunto de dados com valores padrão e informações do usuário: escolha o conjunto de dados que você criou e adicionou à sua análise.

    • Coluna de nome do usuário: para criar padrões baseados em nomes de usuários, escolha a coluna no conjunto de dados que contém os nomes de usuários.

    • Coluna de nome de grupo: para criar padrões baseados em nomes de grupos, escolha a coluna no conjunto de dados que contém os nomes de grupos.

    • Coluna de valor padrão: escolha a coluna que contém valores padrão para este parâmetro.

  4. Escolha Aplicar para salvar as alterações de configurações e, em seguida, selecione Atualizar para salvar as alterações de parâmetros. Para sair sem salvar as alterações, escolha Cancelar em vez disso.

  5. Adicione um filtro para cada campo que contém padrões dinâmicos para que os padrões funcionem. Para saber mais sobre como usar filtros com parâmetros, consulte Como usar filtros com parâmetros no Amazon QuickSight.

    O Amazon QuickSight usa o valor padrão estático para qualquer pessoa cujo nome do usuário não existe no conjunto de dados, não tem um padrão atribuído ou não tem um padrão exclusivo. Cada pessoa pode ter somente um conjunto de padrões. Se você não desejar usar padrões dinâmicos, poderá definir um padrão estático em vez disso.

PrivacidadeTermos do sitePreferências de cookies
© 2025, Amazon Web Services, Inc. ou suas afiliadas. Todos os direitos reservados.