管理 Log Analytics 工作区中的表

在 Azure 门户中查看和设置表属性：

1. 在 Log Analytics 工作区中，选择 表。

   “表”屏幕显示 Log Analytics 工作区中所有表的表配置信息。

   

2. 选择表右侧的省略号 (...) 以打开表管理菜单。

   可用的表管理选项因表类型而异。

   1. 选择“管理表”以编辑表属性。

   2. 选择“编辑架构”以查看和编辑表架构。 即使该 guid 类型可用于表架构中的列，GUID 值也会作为字符串进行存储和查询。 有关详细信息，请参阅 Azure Monitor Logs 中的 Column 数据类型。

若要管理表属性，请调用日志管理 API 的表操作。

下面是如何调用 API 以查看表属性的示例：

GET https://management.chinacloudapi.cn/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}/tables/{tableName}?api-version={api-version}

响应正文

下面是有关如何调用 API 以查看表架构的示例：

GET https://management.chinacloudapi.cn/subscriptions/ContosoSID/resourcegroups/ContosoRG/providers/Microsoft.OperationalInsights/workspaces/ContosoWorkspace/tables/ContainerLogV2?api-version=2025-02-01

示例响应

状态代码：200

{
    "properties": {
        "retentionInDays": 8,
        "totalRetentionInDays": 8,
        "archiveRetentionInDays": 0,
        "plan": "Basic",
        "lastPlanModifiedDate": "2022-01-01T14:34:04.37",
        "schema": {...},
        "provisioningState": "Succeeded"        
    },
    "id": "subscriptions/ContosoSID/resourcegroups/ContosoRG/providers/Microsoft.OperationalInsights/workspaces/ContosoWorkspace",
    "name": "ContainerLogV2"
}

即使在表架构中，列显示为 guid 类型，GUID 值仍以字符串形式存储和查询。 有关详细信息，请参阅 Azure Monitor Logs 中的 Column 数据类型。

若要使用 Azure CLI 查看表属性，请运行 az monitor log-analytics workspace table show 命令。

例如：

az monitor log-analytics workspace table show --subscription ContosoSID --resource-group ContosoRG --workspace-name ContosoWorkspace --name Syslog --output table  

若要使用 Azure CLI 设置表属性，请运行 az monitor log-analytics workspace table update 命令。

若要使用 PowerShell 查看表属性，请运行：

Invoke-AzRestMethod -Path "/subscriptions/ContosoSID/resourcegroups/ContosoRG/providers/microsoft.operationalinsights/workspaces/ContosoWorkspace/tables/Heartbeat?api-version=2025-02-01" -Method GET 

示例响应

{
  "properties": {
    "totalRetentionInDays": 30,
    "archiveRetentionInDays": 0,
    "plan": "Analytics",
    "retentionInDaysAsDefault": true,
    "totalRetentionInDaysAsDefault": true,
    "schema": {
      "tableSubType": "Any",
      "name": "Heartbeat",
      "tableType": "Microsoft",
      "standardColumns": [
        {
          "name": "TenantId",
          "type": "guid",
          "description": "ID of the workspace that stores this record.",
          "isDefaultDisplay": true,
          "isHidden": true
        },
        {
          "name": "SourceSystem",
          "type": "string",
          "description": "Type of agent the data was collected from. Possible values are OpsManager (Windows agent) or Linux.",
          "isDefaultDisplay": true,
          "isHidden": false
        },
        {
          "name": "TimeGenerated",
          "type": "datetime",
          "description": "Date and time the record was created.",
          "isDefaultDisplay": true,
          "isHidden": false
        },
        {
          "name": "ComputerPrivateIPs",
          "type": "dynamic",
          "description": "The list of private IP addresses of the computer.",
          "isDefaultDisplay": true,
          "isHidden": false
        }
      ],
      "solutions": [
        "LogManagement"
      ],
      "isTroubleshootingAllowed": false
    },
    "provisioningState": "Succeeded",
    "retentionInDays": 30
  },
  "id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/ContosoRG/providers/Microsoft.OperationalInsights/workspaces/ContosoWorkspace/tables/Heartbeat",
  "name": "Heartbeat"
}

即使该 guid 类型可用于表架构中的列，GUID 值也会作为字符串进行存储和查询。 有关详细信息，请参阅 Azure Monitor Logs 中的 Column 数据类型。

使用 Update-AzOperationalInsightsTable cmdlet 设置表属性。