在 Amazon QuickSight 中创建参数默认值

创建或编辑适用于所有人的控制面板视图的静态默认值

1. 选择要编辑的参数旁边的上下文菜单 (v)，或通过执行 在 Amazon QuickSight 中设置参数 中的步骤创建新参数。

2. 为静态默认值输入一个值来设置静态默认值。

识别动态默认参数（DDP）的用户

• 列出单个用户名或组名：

  • 要列出单个用户名，请添加一列来识别您 DDP 的用户。此列应包含每个用户用于从您的身份提供者连接到 QuickSight 的系统用户名。此用户名通常与某人 @ 符号之前的电子邮件别名相同，但并非总是如此。

    要获取用户列表，请使用 ListUsers QuickSight API 操作或 AWS CLI 命令。CLI 命令如下例所示。为您的身份提供者指定 AWS 区域，例如 us-east-1。

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

    以下示例通过添加一个将结果限制在活动用户范围内的查询来修改前面的命令。

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

    结果集类似于以下示例。此示例摘自 JSON 输出 (--output json)。拥有联合用户名的人员具有以单词 federated 开头的主体 ID。

    [
        {
            "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"
        }
    ]

  • 要列出组名，请添加一列来识别包含您 DDP 用户名的组。此列应包含用于从您的身份提供者连接到 QuickSight 的系统组名。要识别可以添加到数据集的组，请使用以下一个或多个 QuickSight API 操作或 CLI 命令：

    • ListGroups – 按包含您身份提供者的 AWS 区域 的 AWS 账户 ID 和命名空间列出 QuickSight 组。

    • ListGroupMemberships – 列出指定 QuickSight 组的用户。

    • ListUserGroups – 列出 QuickSight 用户所属的 QuickSight 组。

    您也可以要求自己的网络管理员查询身份提供者来获取此信息。

为单值 DDP 创建数据集

1. 使用单值参数创建数据集列。查询或文件中的第一列应适用于使用控制面板的人员。该字段可以包含用户名或组名。不过，只在 QuickSight 企业版中提供对组的支持。

2. 对于显示单值参数的动态默认值的每个字段，请向数据集添加一列。列名无关紧要，您可以使用与字段或参数相同的名称。

   只有当用户实体和动态默认值的组合对于该参数的字段来说是唯一时，单值参数才能按指定方式生效。如果用户实体的默认字段有多个值，则该字段的单值控件会改为显示静态默认值。如果未定义静态默认值，则该控件不会显示默认值。使用组名时请务必小心，因为有些用户名可以是多个组的成员。如果这些组具有不同的默认值，则此类用户名充当重复条目。

   以下示例演示了似乎包含两个单值参数的表。我们之所以作出这样的假设，是因为没有用户名与多个默认值配对。为了让该表更易于理解，我们在分析的字段名称前添加单词 'default'。因此，您可以通过执行以下语句来读取该表，并更改每行的值：由 anacarolinasilva 查看时，控件会显示默认区域 NorthEast 和默认分段 SMB。

   查看者	默认区域	默认分段
   anacarolinasilva	NorthEast	SMB
   liujie	SouthEast	SMB
   saanvisarkar	NorthCentral	SMB
   zhangwei	SouthCentral	SMB

3. 将该数据导入 QuickSight，再另存为新的数据集。

4. 在分析中添加自己创建的数据集。分析至少需要使用一个与您为默认值定义的列相匹配的其他数据集。有关更多信息，请参阅 向分析中添加数据集。

为多值 DDP 创建数据集

1. 使用多值参数创建数据集列。查询或文件中的第一列应适用于使用控制面板的人员。该字段可以包含用户名或组名。不过，只在 QuickSight 企业版中提供对组的支持。

2. 对于显示多值参数的动态默认值的每个字段，请向数据集添加一列。列名无关紧要，您可以使用与字段或参数相同的名称。

   与单值参数不同，多值参数允许与参数关联的字段中存在多个值。

   以下示例演示了似乎包含一个单值参数和一个多值参数的表。我们之所以作出这样的假设，是因为每个用户名在一列中有唯一值，而有些用户名在另一列中有多个值。为了让该表更易于理解，我们在分析的字段名称前添加单词 'default'。因此，您可以通过执行以下语句来读取该表，并更改每行的值：如果 viewed-by 是 liujie，则控件显示 default-region 值 SouthEast、default-city 值 Atlanta。如果向前读取一行，我们就会看到 liujie 在 default-city 中也有 Raleigh。

   查看者	默认区域	默认城市
   anacarolinasilva	NorthEast	New York
   liujie	SouthEast	亚特兰大
   liujie	SouthEast	罗利
   saanvisarkar	NorthCentral	芝加哥
   zhangwei	SouthCentral	达拉斯
   zhangwei	SouthCentral	堪萨斯城

   在此示例中，无论是单值参数还是多值参数，我们应用 default-region 的参数都能正常生效。如果是单值参数，则两个条目适用于一个用户，因为这两个条目是相同的值，即 SouthEast。如果是多值参数，其仍然有效，只是默认情况下只选择一个值。不过，如果我们将使用 default-city 作为默认值的参数从多值参数更改为单值参数，则不会看到选择这些默认值。相反，如果定义了静态默认值，则该参数使用静态默认值。例如，如果静态默认值设置为 Atlanta，则 liujie 在该控件中选择 Atlanta，而不是 Raleigh。

   在某些情况下，静态默认值也可能用作动态默认值。如果是这样，请测试控件用户名，确保使用的默认值不能同时满足这两种属性。

   如果一个用户名属于多个组，则指定用户会看到一组默认值，这些值是两个组默认值的并集。

3. 将该数据导入 QuickSight，再另存为新的数据集。

4. 在分析中添加自己创建的数据集。分析至少需要使用一个与您为默认值定义的列相匹配的其他数据集。有关更多信息，请参阅 向分析中添加数据集。

向分析中添加 DDP

1. 在 QuickSight 控制台中，选择页面顶部的参数 图标，然后选择一个现有参数。在参数的菜单中选择编辑参数。要添加新参数，请选择参数旁边的加号 (+)。

2. 选择 Set a dynamic default（设置动态默认值）。

3. 使用您的设置配置以下选项：

   • 具有默认值和用户信息的数据集 – 选择您创建并添加到分析中的数据集。

   • 用户名列 – 要创建基于用户名的默认值，请选择数据集中包含用户名的列。

   • 组名列 – 要创建基于组名的默认值，请选择数据集中包含组名的列。

   • 默认值列 – 选择包含该参数默认值的列。

4. 选择应用保存对设置所作的更改，然后选择更新保存对参数所作的更改。要退出而不保存任何更改，请改为选择取消。

5. 为每个包含动态默认值的字段添加筛选条件，让默认值生效。要了解有关将筛选条件与参数结合使用的更多信息，请参阅 在 Amazon QuickSight 中将筛选条件与参数结合使用。

   对于用户名在数据集中不存在、未分配默认值或没有唯一默认值的任何人，Amazon QuickSight 会使用静态默认值。每个人只能有一组默认值。如果不想使用动态默认值，可以设置静态默认值。