查找适用于 InfluxDB 的 Amazon Timestream 数据库实例的连接信息数据库身份验证选项使用参数组

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

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

主题

查找适用于 InfluxDB 的 Amazon Timestream 数据库实例的连接信息
数据库身份验证选项
使用参数组

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

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

实例的端点，即 c5vasdqn0b-3ksj4dla5nfjhi.timestream-influxdb.us-east-1.on.aws:8086。
可以是创建实例时提供的用户名和密码，也可以是有效的访问令牌。

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

重要

作为数据库实例响应对象的一部分，您将收到 influxAuthParametersSecretArn。这将在账户中保存 Secrets Manager 密钥的 ARN。仅在 InfluxDB 数据库实例可用后才会进行填充。该密钥包含 CreateDbInstance 过程中提供的 Influx 身份验证参数。这是只读副本，因为此密钥的任何updates/modifications/deletions副本都不会影响创建的数据库实例。如果您删除此密钥，我们的 API 响应仍将引用已删除的密钥 ARN。

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

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

使用 AWS 管理控制台

登录 AWS 管理控制台并打开亚马逊 Timestream 控制台。
在导航窗格中，选择 InfluxDB 数据库，以显示数据库实例的列表。
选择数据库实例的名称以显示其详细信息。
在摘要部分中，复制端点。另请注意端口号。您将需要端点和端口号才能连接到数据库实例。

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

使用 CLI

要使用查找 InfluxDB 数据库实例的连接信息 AWS CLI，请调用命令。get-db-instance在调用中，查询数据库实例 ID、终端节点、端口和 influxAuthParametersSecretArn。

对于 Linux、macOS 或 Unix：
```
aws timestream-influxdb get-db-instance --identifier id \
 --query "[name,endpoint,influxAuthParametersSecretArn]"
```
对于 Windows：
```
aws timestream-influxdb get-db-instance --identifier id ^
 --query "[name,endpoint,influxAuthParametersSecretArn]"
```
您的输出应类似于以下内容。要访问用户名信息，需查看 InfluxAuthParameterSecret。
```
[
    [
        "mydb",
        "mydbid-123456789012.timestream-influxdb.us-east-1.on.aws",
        8086,
    ]
]
```

创建访问令牌

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

使用 CLI

如果尚未下载、安装和配置 influx CLI。

在配置 influx CLI 配置时，请使用 --username-password 以进行身份验证。


influx config create --config-name YOUR_CONFIG_NAME --host-url "https://yourinstanceid-accountidentifier.timestream-influxdb.us-east-1.on.aws:8086" --org yourorg --username-password admin --active

使用 influx auth create 命令以重新创建运算符令牌。请注意，此过程将导致旧的运算符令牌失效。
```
influx auth create --org kronos --operator
```
获得运算符令牌后，可使用 influx auth list 命令查看所有令牌。可使用 influx auth create 命令创建全访问令牌。

重要

您需要先执行此步骤以获取运算符令牌。然后，您就可以使用 InfluxDB API 或 CLI 创建新的令牌。

使用 InfluxDB UI

使用创建的端点浏览适用于 InfluxDB 的 Timestream 实例，以登录并访问 InfluxDB UI。您需要使用创建 InfluxDB 数据库实例时使用的用户名和密码。您可以从 CreateDbInstance 的响应对象指定的 influxAuthParametersSecretArn 中检索此信息。

或者，您也可以通过适用于 InfluxDB 的 Amazon Timestream 控制台打开 InfluxDB UI：
1. 登录 AWS 管理控制台并打开 InfluxDB 的 Timestream 控制台，网址为。https://console.aws.amazon.com/timestream/
2. 在适用于 InfluxDB 的 Amazon Timestream 控制台的右上角，选择在其中创建数据库实例的 AWS 区域。
3. 在数据库列表中，选择 InfluxDB 实例的名称，以显示其详细信息。在右上角，选择 InfluxDB UI。
登录到 InfluxDB UI 后，使用左侧导航栏导航到加载数据和 API 令牌。
选择生成 API 令牌，然后选择所有访问 API 令牌。
输入 API 令牌的描述，并选择保存。
复制生成的令牌并妥善保存。

重要

通过 InfluxDB UI 创建令牌时，新创建的令牌仅会显示一次。请确保复制这些令牌。否则，您将需要重新创建令牌。

使用 InfluxDB API

使用 POST 请求方法，向 InfluxDB API /api/v2/authorizations 端点发送请求。

请求应包括以下内容：
1. 标头：
  1. 授权：令牌 <INFLUX_OPERATOR_TOKEN>
  2. Content-Type: application/json
2. 请求正文：包含以下属性的 JSON 正文：
  1. 状态：“激活”
  2. 描述：API 令牌描述
  3. orgID：InfluxDB 组织 ID
  4. 权限：对象数组，其中每个对象代表 InfluxDB 资源类型或特定资源的权限。每个权限包含以下属性：
    1. 操作：“读取”或“写入”
    2. 资源：JSON 对象，表示要对其授予权限的 InfluxDB 资源。每个资源至少包含以下属性：orgID：InfluxDB 组织 ID
    3. 类型：资源类型。有关存在哪些 InfluxDB 资源类型的信息，请使用/ api/v2/resources 端点。

以下示例使用 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 支持以下对数据库用户进行身份验证的方法：

密码身份验证 – 数据库实例将执行用户账户的所有管理。可使用 InfluxDB UI、influx CLI 或 InfluxDB API 创建用户、指定密码和管理令牌。
令牌身份验证：数据库实例将执行用户账户的所有管理。可通过 influx CLI 和 InfluxDB API 使用运算符令牌创建用户、指定密码和管理令牌。

加密连接

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

使用参数组

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

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

参数组概述

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

原定设置和自定义参数组

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

创建数据库参数组

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

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

名称必须为 1 到 255 个字母、数字或连字符。
原定设置参数组名称可以包含句点，例如 default.InfluxDB.2.7。但是，自定义参数组名称不能包含句点。
第一个字符必须是字母。
名称不能以“dbpg-”开头
名称不能以连字符结束，也不能包含两个连续的连字符。
如果创建的数据库实例未指定数据库参数组，数据库实例会使用 InfluxDB 引擎默认值。

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

创建新参数组。
更改所需参数的设置。并非参数组中的所有数据库引擎参数都可供修改。
更新数据库实例以使用自定义参数组。有关更新数据库实例的信息，请参阅更新数据库实例。

注意

如果已修改数据库实例以使用自定义参数组，然后启动数据库实例，适用于 InfluxDB 的 Amazon Timestream 会在启动过程中自动重启数据库实例。

目前，自定义参数组创建后将无法进行修改。如果需要更改参数，必须创建新的自定义参数组，并将其分配给需要此配置更改的实例。如果更新现有数据库实例以分配新的参数组，该操作将立即生效并重启实例。

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

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

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

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

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

支持的参数和参数值

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

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

参数	说明	默认值	值	有效范围	备注
flux-log-enabled	包括显示 Flux 查询详细日志的选项	FALSE	布尔值	不适用
日志级别	日志输出级别。InfluxDB 输出严重性级别大于或等于指定级别的日志条目。	info	调试、信息、错误	不适用
no-tasks	禁用任务调度器。如果存在问题的任务阻止 InfluxDB 启动，请使用此选项在未计划或未执行任务的情况下启动 InfluxDB。	FALSE	布尔值	不适用
query-concurrency	允许同时执行的查询数量。设置为 0 表示允许无限数量的并发查询。	0		0 到 256
query-queue-size	执行队列中允许的最大查询数。达到队列限制后，新查询将遭到拒绝。设置为 0 表示允许在队列中进行无限数量的查询。	1024		不适用
tracing-type	在 InfluxDB 中启用跟踪，并指定跟踪类型。默认情况下将禁用跟踪。	""	log、jaeger	不适用
metrics-disabled	禁用暴露内部 InfluxDB 指标的 HTTP/metrics 端点。	FALSE		不适用
http-idle-timeout	服务器在等待新请求时，应保持已建立连接活动的最长持续时间。设置为 `0`，表示未超时。	3m0s	持续时间，单位为 `hours`、`minutes`、`seconds`、`milliseconds`。示例：`durationType=minutes,value=10`	小时： -最小值：0 -最大值：256205 分钟： -最小值：0 -最大值：15372286 秒： -最小值：0 -最大值：922337203 毫秒： -最小值：0 -最大值：922337203685
http-read-header-timeout	服务器尝试读取新请求 HTTP 标头的最长持续时间。设置为 `0`，表示未超时。	10s	持续时间，单位为 `hours`、`minutes`、`seconds`、`milliseconds`。示例：`durationType=minutes,value=10`	小时： -最小值：0 -最大值：256205 分钟： -最小值：0 -最大值：15372286 秒： -最小值：0 -最大值：922337203 毫秒： -最小值：0 -最大值：922337203685
http-read-timeout	服务器尝试读取全部新请求的最长持续时间。设置为 `0`，表示未超时。	0	持续时间，单位为 `hours`、`minutes`、`seconds`、`milliseconds`。示例：`durationType=minutes,value=10`	小时： -最小值：0 -最大值：256205 分钟： -最小值：0 -最大值：15372286 秒： -最小值：0 -最大值：922337203 毫秒： -最小值：0 -最大值：922337203685
http-write-timeout	服务器在处理和响应写入请求时的最长持续时间。设置为 `0`，表示未超时。	0	持续时间，单位为 `hours`、`minutes`、`seconds`、`milliseconds`。示例：`durationType=minutes,value=10`	小时： -最小值：0 -最大值：256205 分钟： -最小值：0 -最大值：15372286 秒： -最小值：0 -最大值：922337203 毫秒： -最小值：0 -最大值：922337203685
influxql-max-select-buckets	`SELECT` 语句可创建的按时间分组的最大存储桶数。`0` 允许无限数量的存储桶。	0	长整型	最小值：0 最大值：9223372036854775807
influxql-max-select-point	`SELECT` 语句可处理的最大点数。`0` 允许无限数量的点。InfluxDB 每秒检查一次点（因此超过最大值的查询不会立即中止）。	0	长整型	最小值：0 最大值：9223372036854775807
influxql-max-select-series	`SELECT` 语句可返回的最大系列数。`0` 允许无限数量的系列。	0	长整型	最小值：0 最大值：9223372036854775807
pprof-disabled	禁用 `/debug/pprof` HTTP 端点。此端点提供运行时分析数据，在调试过程中可能有所帮助。	TRUE	布尔值	不适用	虽然InfluxDB将pprof设置为默认禁用，但将其 AWS 设置为`false`默认值。`true`
query-initial-memory-bytes	为查询分配的内存初始字节数。	0	长整型	最小值：0 最高： query-memory-bytes
query-max-memory-bytes	查询允许的最大内存总字节数。	0	长整型	最小值：0 最大值：9223372036854775807
query-memory-bytes	指定新创建用户会话的生存时间（TTL），以分钟为单位。	0	长整型	最小值：0 最大值：2147483647	必须大于或等于 query-initial-memory-bytes。
session-length	指定新创建用户会话的生存时间（TTL），以分钟为单位。	60	整数	最小值：0 最大值：2880
session-renew-disabled	禁用在每次请求时自动延长用户会话 TTL 的功能。默认情况下，每次请求都会将会话的过期时间设置为从当前时刻起 5 分钟。禁用后，会话将在指定的会话时长后过期，用户将被重定向至登录页面，即使其近期仍处于活跃状态。	FALSE	布尔值	不适用
storage-cache-max-memory-尺寸	分片缓存开始拒绝写入前可达到的最大容量（以字节为单位）。	1,073,741,824	长整型	最小值：0 最大值：549755813888	必须低于实例的总内存容量。建议将其设置为低于总内存容量的 15%。
storage-cache-snapshot-memory-尺寸	存储引擎将对缓存进行快照并将其写入 TSM 文件以释放更多可用内存的大小（以字节为单位）。	26,214,400	长整型	最小值：0 最大值：549755813888	必须小于 storage-cache-max-memory-size。
storage-cache-snapshot-write-寒冷时长	如果分片未收到写入或删除操作，则存储引擎将对缓存进行快照并将其写入新 TSM 文件的持续时间。	10m0s	持续时间，单位为 `hours`、`minutes`、`seconds`、`milliseconds`。示例：`durationType=minutes,value=10`	小时： -最小值：0 -最大值：256205 分钟： -最小值：0 -最大值：15372286 秒： -最小值：0 -最大值：922337203 毫秒： -最小值：0 -最大值：922337203685
storage-compact-full-write-寒冷时长	存储引擎在未收到写入或删除操作时，对分片中所有 TSM 文件执行压缩操作的持续时间。	4h0m0s	持续时间，单位为 `hours`、`minutes`、`seconds`、`milliseconds`。示例：`durationType=minutes,value=10`	小时： -最小值：0 -最大值：256205 分钟： -最小值：0 -最大值：15372286 秒： -最小值：0 -最大值：922337203 毫秒： -最小值：0 -最大值：922337203685
storage-compact-throughput-burst	TSM 压缩可写入磁盘的速率限制（以每秒字节数为单位）。	50,331,648	长整型	最小值：0 最大值：9223372036854775807
storage-max-concurrent-compactions	可同时运行的完整压缩和层级压缩的最大数量。当值为 `0` 时，运行时将使用 50% 的 `runtime.GOMAXPROCS(0)`。任何大于零的数值都会将压缩操作限制在该值范围内。此设置不适用于缓存快照。	0	整数	最小值：0 最大值：64
storage-max-index-log-文件大小	索引预写日志（WAL）文件压缩为索引文件时的大小（以字节为单位）。较小的日志文件大小会导致日志文件更快速地压缩，从而降低堆内存使用率，但会牺牲写入吞吐量。	1,048,576	长整型	最小值：0 最大值：9223372036854775807
storage-no-validate-field-尺寸	跳过传入写入请求的字段大小验证。	FALSE	布尔值	不适用
storage-retention-check-interval	保留策略强制执行检查的时间间隔。	30m0s	持续时间，单位为 `hours`、`minutes`、`seconds`、`milliseconds`。示例：`durationType=minutes,value=10`	不适用	小时： -最小值：0 -最大值：256205 分钟： -最小值：0 -最大值：15372286 秒： -最小值：0 -最大值：922337203 毫秒： -最小值：0 -最大值：922337203685
storage-series-file-max-concurrent-snapshot-compactions	数据库中所有系列分区可并行运行的快照压缩的最大数量。	0	整数	最小值：0 最大值：64
storage-series-id-set-缓存大小	TSI 索引中用于存储先前计算的系列结果的内部缓存大小。当执行具有相同标签 key/value 谓词的后续查询时，可以快速返回缓存的结果，而不必重新计算。将此值设置为 `0` 将禁用缓存，并可能降低查询性能。	100	长整型	最小值：0 最大值：9223372036854775807
storage-wal-max-concurrent-写道	同时尝试写入 WAL 目录的最大次数。	0	整数	最小值：0 最大值：256
storage-wal-max-write-延迟	当 WAL 目录的最大并发活动写入数达到上限时，写入请求在 WAL 目录中等待的最大时长。设置为 `0`，以禁用超时。	10m	持续时间，单位为 `hours`、`minutes`、`seconds`、`milliseconds`。示例：`durationType=minutes,value=10`	小时： -最小值：0 -最大值：256205 分钟： -最小值：0 -最大值：15372286 秒： -最小值：0 -最大值：922337203 毫秒： -最小值：0 -最大值：922337203685
ui-disabled	禁用 InfluxDB 用户界面（UI）。UI 默认已启用。	FALSE	布尔值	不适用

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

使用数据库参数组

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

主题

创建数据库参数组
将数据库参数组与数据库实例关联
列出数据库参数组
查看数据库参数组的参数值

创建数据库参数组

使用 AWS 管理控制台

登录 AWS 管理控制台并打开适用于 InfluxDB 的 Amazon Timestream 控制台。
在导航窗格中，选择参数组。
选择创建参数组。
在参数组名称框中，输入新数据库参数组的名称。
在描述框中，输入新数据库参数组的描述。
选择要修改的参数，并应用所需的值。有关受支持参数的更多信息，请参阅支持的参数和参数值。
选择创建参数组。

使用 AWS Command Line Interface

要使用 AWS CLI 创建数据库参数组，请使用以下参数调用create-db-parameter-group命令：


--db-parameter-group-name <value>
--description <value>
--endpoint_url <value>
--region <value>
--parameters (list) (string)

例示例

有关每项设置的信息，请参阅数据库实例的设置。此示例使用默认的引擎配置。


aws timestream-influxdb create-db-parameter-group 
    --db-parameter-group-name YOUR_PARAM_GROUP_NAME \
    --endpoint-url YOUR_ENDPOINT \
    --region YOUR_REGION \
    --parameters "InfluxDBv2={logLevel=debug,queryConcurrency=10,metricsDisabled=true}" \" \
    --debug

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

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

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

注意

将新数据库参数组与数据库实例关联时，修改后的静态参数仅在数据库实例重新启动后得到应用。目前仅支持立即应用。适用于 InfluxDB 的 Timestream 仅支持静态参数。

使用 AWS 管理控制台

登录 AWS 管理控制台并打开适用于 InfluxDB 的 Amazon Timestream 控制台。
在导航窗格中，选择 InfluxDB 数据库，然后选择要修改的数据库实例。
选择更新。将显示更新数据库实例页面。
更改数据库参数组设置。
选择继续，查看修改摘要。
目前仅支持立即应用。此选项在某些情况下可能会导致中断，因为会重启数据库实例。
在确认页面上，检查您的更改。如果正确无误，请选择更新数据库实例，以保存并应用更改。也可以选择 Back (返回) 编辑您的更改，或选择 Cancel (取消) 取消更改。

使用 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 管理控制台

登录 AWS 管理控制台并打开适用于 InfluxDB 的 Amazon Timestream 控制台。
在导航窗格中，选择参数组。
数据库参数组将显示在列表中。

使用 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 管理控制台

登录 AWS 管理控制台并打开适用于 InfluxDB 的 Amazon Timestream 控制台。
在导航窗格中，选择参数组。
数据库参数组将显示在列表中。
选择参数组名称以查看其参数列表。

使用 AWS Command Line Interface

要查看数据库参数组的参数值，请使用 AWS 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

Javascript 在您的浏览器中被禁用或不可用。

要使用 Amazon Web Services 文档，必须启用 Javascript。请参阅浏览器的帮助页面以了解相关说明。

文档惯例

配置数据库实例

使用只读副本集群