Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅中国的 Amazon Web Services 服务入门。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

管理 Neptune DFE 要使用的统计数据

在计划执行查询时，实验性 DFE 查询引擎使用有关 Neptune 图中数据的信息来进行有效的权衡。此信息采取统计数据的形式，其中包括可以指导查询规划的所谓特征集和谓词统计数据。

默认情况下，当您启用 DFE 时，这些 DFE 统计信息将自动生成。

目前，只要自动生成保持启用状态，只要图表中 10% 以上的数据发生更改，或者当最新统计数据超过 10 天时，就会重新生成 DFE 统计信息，但这些触发器将来可能会发生变化。

您可以通过以下终端节点之一管理 DFE 统计数据的生成：

在下面的例子中，$STATISTICS_ENDPOINT代表这些终端节点 URL 中的任何一个。

DFE 统计数据生成的大小限制

目前，如果达到以下任一大小限制，DFE 统计信息生成将停止：

这些限制可能会改变。

DFE 统计的当前状态

您可以使用以下内容检查 DFE 统计信息的当前状态。curl请求:

curl -G "$STATISTICS_ENDPOINT"

对状态请求的响应包含以下字段：

在没有生成统计信息时，对状态请求的响应如下所示：

{
  "status" : "200 OK",
  "payload" : {
    "autoCompute" : true,
    "active" : false,
    "statisticsId" : -1
   }
}

如果 DFE 统计数据可用，则响应类似于以下内容：

{
  "status" : "200 OK",
  "payload" : {
    "autoCompute" : true,
    "active" : true,
    "statisticsId" : 1588893232718,
    "date" : "2020-05-07T23:13Z",
    "summary" : {
      "signatureCount" : 5,
      "instanceCount" : 1000,
      "predicateCount" : 20
    }
  }
}

如果 DFE 统计信息的生成失败，例如因为它超过数据大小限制，响应类似于以下内容：

{
  "status" : "200 OK",
  "payload" : {
    "autoCompute" : true,
    "active" : false,
    "statisticsId" : 1588713528304,
    "date" : "2020-05-05T21:18Z",
    "note" : "Limit reached: Statistics are not available"
  }
}

禁用自动生成 DFE 统计信息

默认情况下，启用 DFE 时，自动生成 DFE 统计信息将启用。

您可以按如下方式禁用自动生成：

curl -X POST "$STATISTICS_ENDPOINT" -d '{ "mode" : "disableAutoCompute" }'

如果请求成功，则 HTTP 响应代码为200响应如下：

{
  "status" : "200 OK"
}

您可以通过发出状态请求然后检查autoCompute响应中的字段设置为false.

禁用自动生成统计信息并不会终止正在进行的统计计算。

如果您请求禁用读取器实例而不是数据库集群的写入器实例的自动生成，则请求将失败并返回代码为 400，输出如下所示：

{
  "detailedMessage" : "Writes are not permitted on a read replica instance",
  "code" : "ReadOnlyViolationException",
  "requestId":"8eb8d3e5-0996-4a1b-616a-74e0ec32d5f7"
}

请参阅常见错误查看其他常见错误的列表。

重新启用自动生成 DFE 统计信息

默认情况下，启用 DFE 时，已启用 DFE 统计信息的自动生成。如果禁用自动生成，则可以在以后按如下方式重新启用自动生成：

curl -X POST "$STATISTICS_ENDPOINT" -d '{ "mode" : "enableAutoCompute" }'

如果请求成功，则 HTTP 响应代码为200响应如下：

{
  "status" : "200 OK"
}

您可以通过发出状态请求然后检查autoCompute响应中的字段设置为true.

手动触发 DFE 统计数据的生成

您可以按如下方式手动启动 DFE 统计信息生成：

curl -X POST "$STATISTICS_ENDPOINT" -d '{ "mode" : "refresh" }'

如果请求成功，则输出如下所示，HTTP 返回代码为 200：

{
  "status" : "200 OK",
  "payload" : {
    "statisticsId" : 1588893232718
  }
}

这些区域有：statisticsId输出中是当前正在进行的统计生成运行的 ID。如果在请求发出时运行已在处理中，请求将返回该运行的 ID，而不是启动新运行的 ID。一次只能运行一个统计数据生成。

如果在生成 DFE 统计信息时发生故障转移，则新的写入器节点将选择上次处理的检查点并恢复从那里运行的统计信息。

使用StatsNumStatementsScannedCloudWatch 指标用于监控统计计算

这些区域有：StatsNumStatementsScannedCloudWatch 指标返回自服务器启动以来为统计计算而扫描的语句总数。它会在每个统计计算片段中进行更新。

每次触发统计计算时，这个数字都会增加，如果没有进行任何计算，它将保持不变。看一个阴谋StatsNumStatementsScanned因此，随着时间推移的值可以让你非常清楚地了解统计计算的发生时间以及有多快：

当计算进行时，图表的斜率会显示速度有多快（坡度越陡，计算的统计数据就越快）。

如果图表只是 0 处的平线，则已启用统计功能，但根本没有计算任何统计数据。如果已禁用统计功能，或者如果您使用的引擎版本不支持统计计算，则StatsNumStatementsScanned不存在。

如前所述，您可以使用统计API 禁用统计数据计算，但是将其禁用可能会导致统计信息不是最新的，这反过来又可能导致 DFE 引擎的查询计划生成不良。

请参阅使用 Amazon CloudWatch 监控 Neptune有关如何使用 CloudWatch 的信息。

使用Amazon Identity and Access Management(IAM) 使用 DFE 统计端点进行身份验证

您可以使用 IAM 身份验证安全地访问 DFE 统计终端节点awscurl或任何其他与 HTTP 和 IAM 配合使用的工具。传递访问密钥和私有密钥后，您可以使用 IAM 身份验证发出 DFE 统计数据请求。

例如，状态请求：

awscurl --service neptune-db "$STATISTICS_ENDPOINT"

或者，您可以创建名为的 JSON 文件。request.json其中包含：

{ "mode" : "refresh" }

然后你可以像这样手动启动统计信息生成：

awscurl --service neptune-db "$STATISTICS_ENDPOINT" -X POST -d @request.json

删除 DFE 统计数据

您可以通过向统计终端节点发出 HTTP DELETE 请求来删除数据库中的所有统计信息：

curl -X "DELETE" "$STATISTICS_ENDPOINT"

有效的 HTTP 返回代码是：

如果您向读者节点上的统计终端节点发送删除请求，ReadOnlyViolationException被抛出。

DFE 统计信息请求的常见错误代码

以下是向统计数据发出请求结束时可能发生的常见错误列表：

例如，如果在未启用 DFE 和统计信息时提出请求，将收到类似以下内容的响应：

{
  "code" : "BadRequestException",
  "requestId" : "b2b8f8ee-18f1-e164-49ea-836381a3e174",
  "detailedMessage" : "Bad route: /sparql/statistics"
}