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

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

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

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

从引擎版本 1.2.1.0 开始，您可以使用 GetGraphSummaryAPI 或端点从这些统计数据中检索有关图表的摘要信息。summary

目前，每当图形中超过 10% 的数据发生变化或最新的统计数据超过 10 天时，就会重新生成这些 DFE 统计数据。然而，这些触发因素在未来可能会发生变化。

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

在下面的示例中，$STATISTICS_ENDPOINT代表这些端点中的任何一个 URLs。

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

当前，如果达到以下任一大小限制，DFE 统计数据生成就会停止：

这些限制可能会发生变化。

DFE 统计数据的当前状态

您可使用以下 curl 请求检查 DFE 统计数据的当前状态：

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，确认自动生成已禁用。

禁用自动生成统计数据不会终止正在进行的统计数据计算。

如果您请求对读取器实例而不是数据库集群的写入器实例禁用自动生成，则请求将失败，HTTP 返回代码为 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，而不是启动新的运行。一次只能发生一个统计数据生成运行。

如果在生成 DFE 统计数据时发生失效转移，则新的写入器节点将获取上次处理的检查点，并从此处恢复统计数据运行。

使用StatsNumStatementsScanned CloudWatch 指标监控统计数据计算

该StatsNumStatementsScanned CloudWatch 指标返回自服务器启动以来为统计计算而扫描的语句总数。它会在每个统计数据计算切片处更新。

每次触发统计数据计算时，这个数字都会增加，当没有进行任何计算时，它会保持不变。因此，查看一段时间内的 StatsNumStatementsScanned 值图，可以非常清楚地了解统计数据计算发生的时间和速度：

发生计算时，图形的斜率显示出速度有多快（斜率越陡，计算统计数据的速度就越快）。

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

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

有关如何使用的信息，请参阅使用亚马逊监控 Neptune CloudWatch CloudWatch。

对 DFE 统计终端节点使用 Amazon Identity and Access Management (IAM) 身份验证

您可以使用 awscurl 或任何其它支持 HTTPS 和 IAM 的工具，通过 IAM 身份验证安全地访问 DFE 统计数据端点。请参阅将 awscurl 与临时凭证结合使用以安全地连接到启用了 IAM 身份验证的数据库集群，了解如何设置正确的凭证。完成此操作后，您可以发出这样的状态请求：

awscurl "$STATISTICS_ENDPOINT" \
    --region (your region) \
    --service neptune-db

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

{ "mode" : "refresh" }

然后，您可以像这样手动启动统计数据生成：

awscurl "$STATISTICS_ENDPOINT" \
    --region (your region) \
    --service neptune-db \
    -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"
}