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

For large deployments where the number of processes and queues in production approaches the per tenant limit, the number of tables created in the Insights data cube can impact performance. To manage the custom tables Insights creates for a tenant the Insights Admin Custom Table Management tool can be used to remove unneeded tables.

Table Grouping can be used to combine data from multiple Queues or Processes into a single custom table. A grouped custom table only counts as a single table against the custom table limit, regardless of how many Queues or Process are included in the group. If grouping is used on a Queue or Process which already has a custom table enabled, then the previous custom table can be cleaned up via the Clean Up Tables Tab after the grouping is applied. If the previous table is not cleaned up it will still count towards the table limit.

1. Using the UiPath.InsightsAdminTool first used to enable the tenant(s), select the Group Data Tables feature.
2. テーブル グループ化を有効化するテナントを選択します。
3. Provide the Grouping Definition File.

グループ化定義ファイル

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 に自動的に含められます。
• プロセスまたはキューが複数のグループと一致する場合は、一致するすべてのグループに含められます。
• 新しいグループ化ファイルをアップロードすると、以前のグループは削除されます。