为 InfluxDB 只读副本集群创建时间流

InfluxDB 只读副本集群的 Timestream 在不同的可用区中有一个写入数据库实例和至少一个读取器数据库实例。InfluxDB 只读副本集群的 Timestream 可提供高可用性，增加读取工作负载的容量，并在配置故障转移到副本时更快地进行故障转移。

数据库集群先决条件

重要

以下是创建只读副本集群之前需要完成的先决条件。

主题

为数据库集群配置网络
其他先决条件

为数据库集群配置网络

您只能在基于亚马逊 VPC 服务的虚拟私有云 (VPC) 中为 InfluxDB 只读副本数据库集群创建 Timestream。它必须位于至少 Amazon Web Services 区域有三个可用区的中。为数据库集群选择的数据库子网组必须包含至少三个可用区。此配置可确保数据库集群中的每个数据库实例都位于不同的可用区。

要从同一 VPC 中的 EC2 实例以外的资源连接到数据库集群，请手动配置网络连接。

其他先决条件

在创建只读副本集群之前，请考虑以下其他先决条件：

要定制您的数据库集群的配置参数，请通过必需的参数设置来指定数据库集群参数组。有关创建或修改数据库集群参数组的信息，请参阅只读副本集群的参数组。

请确定要为数据库集群指定的 TCP/IP 端口号。有些公司的防火墙将会阻止通往这些默认端口的连接。如果您的公司防火墙阻止默认端口，请为数据库集群选择其他端口。数据库集群中的所有数据库实例均使用相同的端口。

创建数据库集群

你可以使用 Amazon Web Services Management Console、或 Amazon Timestream for InfluxDB API 为 InfluxDB 只读副本数据库集群创建 Timestream。 Amazon CLI

Using the Amazon Web Services Management Console

您可以通过在 “部署设置” 部分中选择带有只读副本的集群来为 InfluxDB 只读副本数据库集群创建 Timestrea m。

要使用控制台创建只读副本数据库集群，请执行以下操作：

登录Amazon Web Services Management Console并打开亚马逊 Timestream 控制台。
在的右上角 Amazon Web Services Management Console，选择要 Amazon Web Services 区域在其中创建只读副本数据库集群的。
在导航窗格中，选择 InfluxDB 数据库。
选择 “创建 InfluxDB 数据库”。
在部署设置中，选择带有只读副本的集群。

选择该选项后，将显示一条消息，提示您需要通过 Amazon Web Services Marketplace 小工具激活订阅。点击查看订阅选项。请注意，订阅可能需要 1-2 分钟才能生效。
订阅激活后，点击查看订阅。
将出现一个窗口，显示每个区域每实例小时每小时 vCPU 的成本信息。这遵循相同的计算定价模型，即根据您选择的实例类型对您的实例处于活动状态的小时数收费。您只需要订阅一次插件，这样您就可以在所有可用 InfluxDB Timestream 的地区创建实例。

重要
要订阅该优惠，您需要拥有 AWSMarketplaceManageSubscriptions 或 AWSMarketplaceFullAccess权限。有关这些权限的更多信息，请查看控制对 Amazon Web Services Marketplace 订阅的访问权限。
确认订阅后，该服务将根据您的实例所在区域自动选择区域。
在数据库凭据中，填写以下字段：
1. 在数据库集群名称中，输入数据库集群的标识符。
2. 提供 InfluxDB 基本的初始配置参数：用户名、组织名称、存储桶名称和密码。
在实例配置中，指定数据库实例类。选择最适合您的工作负载需求的实例大小。请记住，此实例类型将用于只读副本数据库集群中的所有实例。
在存储配置中，选择适合您需求的存储类型。在所有情况下，您只需要配置分配的存储空间即可。请记住，此存储类型将用于只读副本数据库集群中的所有实例。
在连接配置部分中，确保您的InfluxDB集群与需要连接到InfluxDB数据库实例的时间流的客户端位于同一个子网中。您也可以选择在公开访问小节中公开您的数据库实例。
选择 “创建 InfluxDB 数据库”。
在 InfluxDB 数据库列表中，选择您的新 InfluxDB 集群的名称以显示其详细信息。数据库集群的状态将为 “正在创建”，直到它准备好使用为止。
当状态更改为 “可用” 时，您可以连接到数据库集群。根据数据库实例类和存储量，新实例可能需要等待 20 分钟时间才可用。
创建完成后，您可以单击数据库集群标识符来检索有关新创建的集群的信息。显示实例模式为 PRIMARY 的终端节点是您需要用于写入和引擎管理的终端节点。

Using the Amazon CLI

要使用创建数据库实例 Amazon Command Line Interface，请使用以下参数调用create-db-cluster命令。将每个 user input placeholder 替换为您自己的信息。


aws timestream-influxdb create-db-cluster \
      --region region \
      --vpc-subnet-ids subnet-ids \
      --vpc-security-group-ids security-group-ids \
      --db-instance-type db.influx.large \
      --db-storage-type InfluxIOIncludedT2 \
      --allocated-storage 400 \
      --password password \ 
      --name cluster-name \
      --deployment-type MULTI_NODE_READ_REPLICAS \
      --publicly-accessible
      //--failover-mode is optional and defaults to AUTOMATIC.

创建只读副本集群的设置

有关您在创建只读副本集群时选择的设置的详细信息，请参阅下表。有关这些 Amazon CLI 选项的更多信息，请参阅create-db-cluster。有关适用于 InfluxDB 的 Amazon Timestream API 参数的更多信息，请参阅。CreateDbCluster

控制台设置	设置说明	InfluxDB 的 CLI 选项和 Timestream API 参数
分配的存储空间	为数据库集群中的每个数据库实例分配的存储量（以 GiB 为单位）。有关更多信息，请参阅 InfluxDB 实例存储。	CLI 选项：`--allocated-storage` API 参数：`allocatedStorage`
数据库端口	InfluxDB 接受连接的端口号。有效值：1024-65535 默认值：8086 限制：该值不能是 2375-2376、7788-7799、8090 或 51678-51680。	CLI 选项：`--port` API 参数：`port`
数据库集群名称	唯一标识数据库集群的名称。每个客户和每个区域的数据库实例名称必须是唯一的。	CLI 选项：`--name` API 参数：`name`
数据库实例类型	例如，InfluxDB 数据库集群的 Timestream 中每个数据库实例的计算和内存容量。`db.influx.xlarge` 如有可能，请选择足够大的数据库实例类以便典型查询工作集能够保留在内存中。如果在内存中保留工作集，系统可以避免写入到磁盘，从而提高性能。	CLI 选项：`--db-instance-type` API 参数：`dbInstanceType`
数据库集群参数组	要分配给数据库集群的数据库参数组的 ID。数据库参数组指定数据库的配置方式。例如，数据库参数组可以指定查询并发的限制。	CLI 选项：`--db-parameter-group-identifier` API 参数：`dbParameterGroupIdentifier`
Deployment type（部署类型）	指定将数据库集群部署为多节点只读副本还是多可用区多节点只读副本。可能的值：`MULTI_NODE_READ_REPLICAS`	CLI 选项：`--deployment-type` API 参数：`deploymentType`
VPC 子网 ID	要用于数据库集群的数据库子网 ID。选择选择现有以使用现有的数据库子网组，然后从现有数据库子网组下拉列表中选择所需的子网组。选择 “自动设置”，让 InfluxDB 的 Timestream 选择兼容的数据库子网组。	CLI 选项：`--vpc-subnet-ids` API 参数：`vpcSubnetIds`
组织	InfluxDB 中初始管理员用户的初始组织名称。InfluxDB 组织是一组用户的工作空间。	CLI 选项：`--organization` API 参数：`organization`
存储桶	初始 InfluxDB 存储桶的名称。所有 InfluxDB 数据都存储在一个存储桶中。存储桶结合了数据库的概念和保留期（每个数据点的持续时间）。存储桶属于组织。	CLI 选项：`--bucket` API 参数：`bucket`
日志导出	用于将 InfluxDB 引擎日志发送到指定的 S3 存储桶的配置。 S3 存储桶日志传输的配置：`s3Configuration -> (structure)` 要将日志传送到的 S3 存储桶的名称：`bucketName -> (string)` 表示是否已启用向 S3 存储桶传输日志：`enabled -> (boolean)` 速记语法：`s3Configuration={bucketName=string, enabled=boolean}`	CLI 选项：`--log-delivery-configuration` API 参数：`logDeliveryConfiguration`
密码	您在InfluxDB中创建的初始管理员用户的密码。此密码将允许您访问InfluxDB用户界面以执行各种管理任务，还可以使用InfluxDB CLI创建操作员令牌。这些属性将存储在您的账户中创建的密钥 Amazon Secrets Manager 中。	CLI 选项：`--password` API 参数：`password`
用户名	在 InfluxDB 中创建的初始管理员用户的用户名。必须以字母开头，不能以连字符结尾或包含两个连续的连字符。例如，my-user1。此用户名将允许您访问InfluxDB用户界面以执行各种管理任务，还可以使用InfluxDB CLI创建操作员令牌。这些属性将存储在您的账户中创建的密钥 Amazon Secrets Manager 中。	CLI 选项：`--username` API 参数：`username`
公有访问权限	表示是否可以从 VPC 外部访问数据库集群。可公开访问为数据库集群提供了一个公有 IP 地址，这意味着它可以在 VPC 外部进行访问。要可供公开访问，数据库集群还必须在 VPC 的公有子网中。由于不可公开访问，因此只能从 VPC 内部访问数据库集群。	CLI 选项：`--publicly-accessible--no-publicly-accessible` API 参数：`publiclyAccessible`
数据库存储类型	InfluxDB 数据。您可以根据工作负载的要求在三种不同类型的预配置 Influx IOPS 内含存储之间进行选择。可能的值： Influx T1 IOIncluded Influx T2 IOIncluded Influx T3 IOIncluded	CLI 选项：`--db-storage-type--no-publicly-accessible` API 参数：`dbStorageType`
VPC 安全组	IDs 要与数据库实例关联的 VPC 安全组列表。	CLI 选项：`--vpc-security-group-ids--no-publicly-accessible` API 参数：`vpcSecurityGroupIds`
VPC 子网 IDs	IDs 要与数据库实例关联的 VPC 子网列表。使用 InfluxDB 数据库集群的 Timestream 部署时， IDs 在不同的可用区中至少提供两个 VPC 子网。	CLI 选项：`--vpc-subnet-ids` API 参数：`vpcSubnetIds`
故障切换模式	您的集群如何响应主实例故障。您可以使用以下选项进行配置： `AUTOMATIC`：如果主实例出现故障，系统会自动将只读副本提升为新的主实例。 `NO_FAILOVER`：如果主实例出现故障，系统会尝试在不提升只读副本的情况下恢复主实例。在主实例恢复之前，集群将保持不可用状态。	CLI 选项：`--failover-mode` API 参数：`failoverMode`

重要

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

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

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

只读副本集群概述

连接到只读副本数据库集群