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

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

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

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

数据库实例的连接信息包括其终端节点、端口、用户名、密码和有效的访问令牌，例如操作员或所有访问令牌。例如，对于 InfluxDB 数据库实例，假设终端节点值为。influxdb1-123456789.us-east-1.timestream-influxdb.amazonaws.com在本例中，端口值为 8086，数据库用户为管理员。鉴于此信息，您可以在连接字符串中指定以下值：

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

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

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

创建访问令牌

有了这些信息，您将能够连接您的实例，以检索或创建您的访问令牌。有几种方法可以实现这一点：

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

export INFLUX_HOST=https://influxdb1-123456789.us-east-1.timestream-influxdb.amazonaws.com
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 使用默认设置定义参数组。您还可以使用自定义设置定义您自己的参数组。

参数组概述

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

原定设置和自定义参数组

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

创建数据库参数组

您可以使用 AWS Management Console、或 Timestream API 创建新的数据库参数组。 AWS Command Line Interface

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

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

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

InfluxDB 数据库实例参数始终是静态的。它们的行为如下：

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

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

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

支持的参数和参数值

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

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

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

使用数据库参数组

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

创建数据库参数组

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

您可以使用自定义设置创建自己的数据库参数组。您可以使用 AWS Management Console、或 Timestream API-InfluxDB 将数据库参数组与数据库实例关联起来。 AWS Command Line Interface在创建或修改数据库实例时可以执行此操作。

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

使用 AWS 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 }}"
                        
 

列出数据库参数组

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

使用 AWS Command Line Interface

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

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

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

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

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

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

使用 AWS Command Line Interface

要查看数据库参数组的参数值，请使用带有以下必需参数的 AWS Command Line Interface get-db-parameters命令。

--db-parameter-group-name

使用 API

要查看数据库参数组的参数值，请使用带有以下必需参数的 Timestream API GetDBParameters 命令。

DBParameterGroupName