在 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） 的摘錄。具有聯合使用者名稱的人員，其主體以 字IDs開頭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"
        }
    ]

  • 若要列出群組名稱，請包含一欄，以識別包含 使用者名稱的群組DDP。此欄應包含用於從身分提供者連線至 的系統群組名稱 QuickSight。若要識別您可以新增至資料集的群組，請使用下列 QuickSight API一或多個操作或CLI命令：

    • ListGroups – 列出包含您身分提供者之 AWS 區域 的 AWS 帳戶 ID 和命名空間 QuickSight 群組。

    • ListGroupMemberships – 列出指定 QuickSight 群組中的使用者。

    • ListUserGroups – QuickSight列出 QuickSight 使用者所屬的群組。

    或者，您可以要求網路管理員查詢您的身分提供者以取得此資訊。

為單一值建立資料集 DDP

1. 使用單值參數建立資料集資料欄。查詢或檔案中的第一欄應適用於使用儀表板的人員。此欄位可以包含使用者名稱或群組名稱。不過， 群組的支援僅適用於 QuickSight Enterprise Edition。

2. 針對每個顯示單值參數動態預設值的欄位，將資料欄新增至資料集。資料欄的名稱並不重要，您可以使用與欄位或參數相同的名稱。

   如果使用者實體和動態預設值的組合對該參數的欄位而言是唯一的，則單值參數才能正常運作。如果使用者實體的預設欄位有多個值，則該欄位的單一值控制項會改為顯示靜態預設值。如果未定義靜態預設值，則控制項不會顯示預設值。如果您使用群組名稱，則請務必小心，因為某些使用者名稱可能是多個群組的成員。如果這些群組具有不同的預設值，則此類型的使用者名稱會當做重複項目運作。

   下列範例顯示包含兩個單值參數的資料表。我們這樣假設是因為沒有使用者名稱與多個預設值配對。為了使此表更易於理解，我們在分析中的字段名稱前面新增單字 'default'。因此，您可以透過下列陳述式、變更每個資料列的值來讀取資料表：由 anacarolinasilva 檢視時，控制項會顯示預設區域 NorthEast 與預設區段 SMB。

   檢視者	預設區域	預設區段
   anacarolinasilva	NorthEast	SMB
   liujie	SouthEast	SMB
   saanvisarkar	NorthCentral	SMB
   zhangwei	SouthCentral	SMB

3. 將此資料匯入 QuickSight，並將其儲存為新資料集。

4. 在分析中，新增您建立的資料集。分析需要至少使用一個與您為預設值定義之資料欄相符的其他資料集。如需詳細資訊，請參閱將資料集新增至分析。

建立多值的資料集 DDP

1. 使用多值參數建立資料集資料欄。查詢或檔案中的第一欄應適用於使用儀表板的人員。此欄位可以包含使用者名稱或群組名稱。不過， 群組的支援僅適用於 QuickSight Enterprise Edition。

2. 針對每個顯示多值參數動態預設值的欄位，將資料欄新增至資料集。資料欄的名稱並不重要，您可以使用與欄位或參數相同的名稱。

   與單值參數不同，多值參數允許在與參數相關聯的欄位中使用多個值。

   下列範例顯示包含一個單值參數和一個多值參數的資料表。我們可以進行此假設，因為每個使用者名稱在一個資料欄中都有唯一的值，並且某些使用者名稱在另一資料欄中具有多個值。為了使此表更易於理解，我們在分析中的字段名稱前面新增單字 'default'。因此，您可以透過建立下列陳述式、變更每一列的值來讀取資料表：如果 viewed-by 是 liujie，控制項會顯示 default-region 的值 SouthEast，以及 default-city 的值 Atlanta。如果我們提前讀一列，就會看到，liujie 在 default-city 中還有 Raleigh。

   檢視者	預設區域	預設城市
   anacarolinasilva	NorthEast	紐約
   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. 使用您的設定配置以下選項：

   • Dataset with default values and user information – 選擇您建立並新增至分析的資料集。

   • 使用者名稱資料欄 – 若要建立以使用者名稱為基礎的預設值，請在資料集中選擇包含使用者名稱的資料欄。

   • 群組名稱資料欄 – 若要建立以群組名稱為基礎的預設值，請在資料集中選擇包含群組名稱的資料欄。

   • 適用於預設值的資料欄 – 選擇包含此參數預設值的資料欄。

4. 選擇套用以儲存設定變更，然後選擇更新以儲存參數變更。若要退出而不儲存變更，則請選擇取消。

5. 為每個包含動態預設值的欄位新增篩選條件，以使預設值正常運作。若要進一步了解如何使用篩選條件與參數搭配，請參閱 在 Amazon 中使用具有參數的篩選條件 QuickSight

   Amazon QuickSight 會將靜態預設值用於任何其使用者名稱不存在於資料集、未指派預設值，或沒有唯一預設值的人。每個人只能有一組預設值。若您不想使用動態預設值，則可以設定靜態預設值。