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

要获得与亚马逊 Timestream 类似的功能 LiveAnalytics，可以考虑适用于 InfluxDB 的亚马逊 Timestream。适用于 InfluxDB 的 Amazon Timestream 提供简化的数据摄取和个位数毫秒级的查询响应时间，以实现实时分析。点击此处了解更多信息。

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

连接到适用于 InfluxDB 的 Amazon Timestream 数据库实例

在连接到数据库实例之前，您必须先创建数据库实例。有关信息，请参阅创建数据库实例。在 Amazon Timestream 预配置数据库实例后，使用 InfluxDB API、influx CLI 或任何与 InfluxDB 兼容的客户端或实用程序连接到该数据库实例。

查找适用于 InfluxDB 的 Amazon Timestream 数据库实例的连接信息

数据库实例的连接信息包括其端点、端口、用户名、密码和有效的访问令牌（例如运算符令牌或全访问令牌）。例如，对于适用于 InfluxDB 的 Timestream 数据库实例，假设端点值是 c5vasdqn0b-3ksj4dla5nfjhi.timestream-influxdb.us-east-1.on.aws。在这种情况下，端口值是 8086，数据库用户是管理员。根据这些信息，要访问实例，您将使用：

在 2024 年 12 月 9 日之前创建的实例，其端点将包含实例名称而非实例 ID。例如：influxdb1-123456789.us-east-1.timestream-influxdb.amazonaws.com。

端点对于每个数据库实例都是唯一的，端口和用户的值可能会有所不同。要连接到数据库实例，可使用 influx CLI、InfluxDB API 或任何与 InfluxDB 兼容的客户端。

要查找数据库实例的连接信息，请使用 Amazon 管理控制台。你也可以使用 Amazon 命令行界面 (Amazon CLI) describe-db-instances 命令或 InfluxDB 的 Timestream API 操作。GetDBInstance

如果您需要查找用户名和密码信息，请选择配置详细信息选项卡，然后选择 influxAuthParametersSecretArn 以访问 Secrets Manager。

创建访问令牌

使用这些信息，您将能够连接到您的实例，以检索或创建访问令牌。可通过多种方式实现这一目的：

以下示例使用 curl 和 InfluxDB API 生成全访问令牌：

export INFLUX_HOST=https://instanceid-123456789.timestream-influxdb.us-east-1.on.aws
export INFLUX_ORG_ID=<YOUR_INFLUXDB_ORG_ID>
export INFLUX_TOKEN=<YOUR_INFLUXDB_OPERATOR_TOKEN>

curl --request POST \
"$INFLUX_HOST/api/v2/authorizations" \
  --header "Authorization: Token $INFLUX_TOKEN" \
  --header "Content-Type: text/plain; charset=utf-8" \
  --data '{
    "status": "active",
    "description": "All access token for get started tutorial",
    "orgID": "'"$INFLUX_ORG_ID"'",
    "permissions": [
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "authorizations"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "authorizations"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "buckets"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "buckets"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "dashboards"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "dashboards"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "orgs"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "orgs"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "sources"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "sources"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "tasks"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "tasks"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "telegrafs"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "telegrafs"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "users"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "users"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "variables"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "variables"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "scrapers"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "scrapers"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "secrets"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "secrets"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "labels"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "labels"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "views"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "views"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "documents"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "documents"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "notificationRules"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "notificationRules"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "notificationEndpoints"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "notificationEndpoints"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "checks"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "checks"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "dbrp"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "dbrp"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "notebooks"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "notebooks"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "annotations"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "annotations"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "remotes"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "remotes"}},
      {"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "replications"}},
      {"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "replications"}}
    ]
  }
'

数据库身份验证选项

适用于 InfluxDB 的 Amazon Timestream 支持以下对数据库用户进行身份验证的方法：

加密连接

您可以使用应用程序中的安全套接字层 (SSL) 或传输层安全 (TLS) 来加密与数据库实例的连接。InfluxDB 与由 Kronos 服务创建和管理的应用程序之间进行 TLS 握手所需的证书。续订证书后，实例会自动更新为最新版本，无需任何用户干预。

使用参数组

数据库参数指定数据库的配置方式。例如，数据库参数可以指定要分配给数据库的资源量（如内存）。

您可以通过将数据库实例与参数组进行关联以管理数据库配置。适用于 InfluxDB 的 Amazon Timestream 使用默认设置定义参数组。您还可以使用自定义设置定义您自己的参数组。

参数组概述

数据库参数组就像是引擎配置值的容器，这些值应用于一个或多个数据库实例。

原定设置和自定义参数组

数据库实例使用数据库参数组。以下各节介绍配置和管理数据库实例参数组。

创建数据库参数组

您可以使用 Amazon Web Services 管理控制台、或 Timestream API 创建新的数据库参数组。 Amazon Command Line Interface

以下限制适用于数据库参数组名称：

默认参数组的参数设置无法修改。您可以改而执行以下操作：

静态和动态数据库实例参数

InfluxDB 数据库实例参数始终为静态参数。其行为如下所示：

更改静态参数、保存实例数据库参数组、将该参数分配给示例时，参数更改将在实例重启后自动生效。

将新数据库参数组与数据库实例关联时，Timestream 将仅在数据库实例重启后才应用修改后的静态参数。目前唯一的选择是立即应用。

有关更改数据库集群参数组的信息，请参阅更新数据库实例。

支持的参数和参数值

要确定数据库实例支持的参数，请查看数据库实例所使用数据库参数组中的参数。有关更多信息，请参阅查看数据库参数组的参数值。

有关 InfluxDB 开源版本支持的所有参数的更多信息，请参阅 InfluxDB 配置选项。目前仅可修改以下 InfluxDB 参数：

在参数组内设置参数不恰当可能会产生意外的不利影响，包括性能降低和系统不稳定。修改数据库参数时务必保持谨慎。将参数组更改应用于生产数据库实例前，先在测试数据库实例上测试这些参数组设置更改。

使用数据库参数组

数据库实例使用数据库参数组。以下各节介绍配置和管理数据库实例参数组。

创建数据库参数组

将数据库参数组与数据库实例关联

您可以使用自定义设置创建自己的数据库参数组。您可以使用 Amazon Web Services 管理控制台、或 InfluxDB 的 Timestream AP Amazon Command Line Interface I 将数据库参数组与数据库实例关联起来。在创建或修改数据库实例时可以执行此操作。

有关创建数据库参数组的信息，请参阅创建数据库参数组。有关创建数据库实例的信息，请参阅创建数据库实例。有关修改 数据库实例的信息，请参阅更新数据库实例。

使用 Amazon Command Line Interface

对于 Linux、macOS 或 Unix：

aws timestream-influxdb update-db-instance 
--identifier YOUR_DB_INSTANCE_ID \
--region YOUR_REGION \
--db-parameter-group-identifier YOUR_PARAM_GROUP_ID \
--log-delivery-configuration "{\"s3Configuration\": {\"bucketName\": \"${LOGGING_BUCKET}\", \"enabled\": false }}"

对于 Windows：

aws timestream-influxdb update-db-instance 
--identifier YOUR_DB_INSTANCE_ID ^
--region YOUR_REGION ^
--db-parameter-group-identifier YOUR_PARAM_GROUP_ID ^
--log-delivery-configuration "{\"s3Configuration\": {\"bucketName\": \"${LOGGING_BUCKET}\", \"enabled\": false }}"
                        
 

列出数据库参数组

您可以列出您为 Amazon 账户创建的数据库参数组。

使用 Amazon Command Line Interface

要列出 Amazon 账户的所有数据库参数组，请使用 Amazon Command Line Interface list-db-parameter-groups命令。

aws timestream-influxdb list-db-parameter-groups --region region

要返回 Amazon 账户的特定数据库参数组，请使用 Amazon Command Line Interface get-db-parameter-group命令。

aws timestream-influxdb get-db-parameter-group --region region --identifier identifier

查看数据库参数组的参数值

您可获得数据库参数组内所有参数的列表及它们的值。

使用 Amazon Command Line Interface

要查看数据库参数组的参数值，请使用 Amazon Command Line Interface get-db-parameter-group命令。parameter-group-identifier用您自己的信息替换。

get-db-parameter-group --identifier parameter-group-identifier

使用 API

要查看数据库参数组的参数值，请使用 Timestream API GetDbParameterGroup 命令。parameter-group-identifier用您自己的信息替换。

GetDbParameterGroup parameter-group-identifier