テーブルのグループ化を有効化する

大規模なデプロイ環境の場合、稼働中のプロセスとキューの数がテナントあたりの制限に近づくと、Insights データ キューブ内に作成されるテーブルの数も増え、パフォーマンスに影響を及ぼす場合があります。Insights でテナントに対して作成されるカスタム テーブルを管理するには、Insights 管理ツールのカスタム テーブル管理機能を使用して、不要なテーブルを削除します。

テーブルのグループ化機能を使用すると、複数のキューやプロセスのデータを単一のカスタム テーブルに結合できます。グループ化されたカスタム テーブルは、そのグループに含まれるキューやプロセスの数に関わらず、カスタム テーブルの制限に対して 1 つのテーブルとしてカウントされます。カスタム テーブルがあらかじめ有効化されているキューまたはプロセスでグループ化機能を使用した場合は、グループ化が適用された後に [テーブルをクリーンアップ] タブから以前のカスタム テーブルをクリーンアップできます。以前のテーブルをクリーンアップしないと、そのテーブルも制限に対するカウント対象となります。

1. テナントを有効化するために最初に使用した UiPath.InsightsAdminTool を使用して、[データ テーブルをグループ化] 機能を選択します。
2. テーブル グループ化を有効化するテナントを選択します。
3. グループ化定義ファイルを指定します。

グループ化定義ファイル

UiPath.InsightsAdminTool の実行時には、次のスキーマ定義を使用して、.json ファイルに目的の表のグループ化を設定する必要があります。

{
  "definitions": {},
  "$schema": "http://json-schema.org/draft-07/schema#",
  "$id": "http://example.com/root.json",
  "type": "object",
  "title": "The Root Schema",
  "required": [
    "groups"
  ],
  "properties": {
    "groups": {
      "$id": "#/properties/groups",
      "type": "array",
      "title": "The Groups Schema",
      "items": {
        "$id": "#/properties/groups/items",
        "type": "object",
        "title": "The Items Schema",
        "required": [
          "tenantId",
          "elasticubeNameTemplate",
          "groupName",
          "dataSource"
        ],
        "properties": {
          "tenantId": {
            "$id": "#/properties/groups/items/properties/tenantId",
            "type": "integer",
            "title": "The Tenantid Schema",
            "default": 0,
            "examples": [
              3
            ]
          },
          "elasticubeNameTemplate": {
            "$id": "#/properties/groups/items/properties/elasticubeNameTemplate",
            "type": "string",
            "title": "The Elasticubenametemplate Schema",
            "default": "",
            "examples": [
              "{TENANT}-Cube"
            ],
            "pattern": "^{TENANT}-(.<em>)$"
          },
          "groupName": {
            "$id": "#/properties/groups/items/properties/groupName",
            "type": "string",
            "title": "The Groupname Schema",
            "default": "",
            "examples": [
              "Group_1"
            ],
            "pattern": "^(.</em>)$"
          },
          "dataSource": {
            "$id": "#/properties/groups/items/properties/dataSource",
            "type": "string",
            "title": "The Datasource Schema",
            "default": "",
            "enum": [
              "Process",
              "Queue"
            ],
            "pattern": "^(.<em>)$"
          },
          "likeGrouping": {
            "$id": "#/properties/groups/items/properties/likeGrouping",
            "type": "object",
            "title": "The Likegrouping Schema",
            "required": [
              "likeClause"
            ],
            "properties": {
              "likeClause": {
                "$id": "#/properties/groups/items/properties/likeGrouping/properties/likeClause",
                "type": "string",
                "title": "The Likeclause Schema",
                "default": "",
                "examples": [
                  "%1",
                  "test",
                  "%"
                ],
                "pattern": "^(.</em>)$"
              },
              "excludeLikeClause": {
                "$id": "#/properties/groups/items/properties/likeGrouping/properties/excludeLikeClause",
                "type": "string",
                "title": "The Excludelikeclause Schema",
                "default": "",
                "examples": [
                  "%1",
                  "test",
                  "%"
                ],
                "pattern": "^(.<em>)$"
              }
            }
          },
          "inGrouping": {
            "$id": "#/properties/groups/items/properties/likeGrouping",
            "type": "object",
            "title": "The Ingrouping Schema",
            "required": [
              "elements"
            ],
            "properties": {
              "elements": {
                "$id": "#/properties/groups/items/properties/likeGrouping/properties/likeClause",
                "type": "array",
                "title": "The Elements Schema",
                "default": "",
                "pattern": "^(.</em>)$"
              }
            }
          }
        }
      }
    }
  }
}

場所：

• groupName - Insights キューブでテーブルに付けられる名前です。最大 75 個のグループを作成できます。
• tenantId - グループ化が適用されるテナントの ID です。
• dataSource - データ ソースが Process と Queue のどちらなのかを指定します。
• オプション: elasticcubeNameTemplate - Insights キューブの名前。既定では {TENANT}-Cube です。グループ化された表を別のキューブに移動させる場合は、この名前を指定します。たとえば、{TENANT}-DocCube のようになります。表の作成時にはテナント名が代用されるので、Default テナントがターゲットになっている場合、表は Default-DocCube に追加されます。

例:

{
  "groups": [
    {
      "groupName": "Group_1",
      "tenantId": 3,
      "dataSource": "Process",
      "likeGrouping": {
        "likeClause": "%1"
      }
    },
    {
      "groupName": "Group_3",
      "tenantId": 3,
      "dataSource": "Process",
      "likeGrouping": {
        "likeClause": "%3",
        "excludeLikeClause": "%Environment_1%"
      }
    },
    {
      "groupName": "Doc_1+2",
      "tenantId": 3,
      "elasticubeNameTemplate": "{TENANT}-DocCube",
      "dataSource": "Queue",
      "inGrouping": {
        "elements": ["Doc", "Doc2"]
      }
    },
    {
      "groupName": "TestQueues",
      "tenantId": 3,
      "elasticubeNameTemplate": "{TENANT}-Test-Cube",
      "dataSource": "Queue",
      "likeGrouping": {
        "likeClause": "%Test"
      }
    }
  ]
}

重要:

• グループ化定義ファイルの likeClause に設定できる値は 1 つのみです。ただし、excludeLikeClause にはコンマで区切られた複数の値を設定することができます。
• Insights では列数が 40 を超えるテーブルはサポートされません。そのため、テーブルあたりのカスタム フィールドの数が 40 を超えるグループは作成しないでください。
• 新しいプロセスまたはキューが Orchestrator に追加されて実行される際、そのプロセスまたはキューが既存のグループ名と一致する場合はグループに追加され、Insights に自動的に含められます。
• プロセスまたはキューが複数のグループと一致する場合は、一致するすべてのグループに含められます。
• 新しいグループ化ファイルをアップロードすると、以前のグループは削除されます。