

要获得与亚马逊 Timestream 类似的功能 LiveAnalytics，可以考虑适用于 InfluxDB 的亚马逊 Timestream。适用于 InfluxDB 的 Amazon Timestream 提供简化的数据摄取和个位数毫秒级的查询响应时间，以实现实时分析。点击[此处](https://docs.aws.amazon.com//timestream/latest/developerguide/timestream-for-influxdb.html)了解更多信息。

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

# 配置数据库实例
<a name="timestream-for-influx-configuring"></a>

本节介绍如何设置适用于 InfluxDB 的 Amazon Timestream 数据库实例。在创建数据库实例之前，请确定将运行该数据库实例的数据库实例类。此外，通过选择 AWS 区域来决定数据库实例的运行位置。接下来，创建数据库实例。

您可以通过数据库参数组配置数据库实例。数据库参数组作为容器，用于存储应用于一个或多个数据库实例的引擎配置值。

可用的参数取决于数据库引擎和数据库引擎版本。您可以在创建数据库实例时指定数据库参数组。也可以修改数据库实例来指定它们。

**重要**  
此时，无法修改现有实例的计算（实例类型）和存储（存储类型）配置。

## 创建数据库实例
<a name="timestream-for-influx-configuring-create-db"></a>

**使用控制台**

1. 登录 AWS 管理控制台 并打开适用于 InfluxDB 的 [Amazon Timestream。](https://console.aws.amazon.com/timestream/)

1. 在适用于 InfluxDB 的 Amazon Timestream 控制台的右上角，选择 AWS 要在其中创建数据库实例的区域。

1. 在导航窗格中，选择 **InfluxDB 数据库**。

1. 选择**创建 Influx 数据库**。

1. 对于**数据库实例标识符**，输入用于标识实例的名称。

1. 提供 InfluxDB 基本配置参数：**用户名、组织、存储桶名称和密码**。
**重要**  
您的用户名、组织、存储桶名称和密码将作为密钥存储在将为您的账户创建的 S AWS ecrets Manager 中。

   如果需要在数据库实例可用后更改用户密码，可使用 [Influx CLI](https://docs.influxdata.com/influxdb/v2/admin/users/change-password/) 进行修改。

1. 

1. 对于**数据库实例类别**，请选择更适合工作负载需求的实例大小。

1. 对于**数据库存储类别**，请选择适合需求的存储类别。在所有情况下，仅需要配置已分配的存储空间。

1. 在**连接配置**部分，请确保 InfluxDB 实例与需要连接到适用于 InfluxDB 的 Timestream 数据库实例的新客户端位于同一子网中。您也可以选择将数据库实例设为公开可用。

1. 选择**创建 Influx 数据库**。

1. 在**数据库**列表中，选择新 InfluxDB 实例的名称，以显示其详细信息。数据库实例具有**正在创建**状态，直到此实例就绪可供使用。

1. 当状态变为 **Available**（可用）时，您便可以连接到该数据库实例。根据数据库实例类和存储量，新实例可能需要等待 20 分钟时间才可用。

 **使用 CLI**

要使用创建数据库实例 AWS Command Line Interface，请使用以下参数调用`create-db-instance`命令：

```
--name
--vpc-subnet-ids
--vpc-security-group-ids
--db-instance-type
--db-storage-type
--username
--organization
--password
--allocated-storage
```

有关每项设置的信息，请参阅[数据库实例的设置](#timestream-for-influx-configuring-create-db-settings)。

**Example 示例：使用默认引擎配置**  

对于 Linux、macOS 或 Unix：

```
aws timestream-influxdb create-db-instance \
    --name myinfluxDbinstance \
    --allocated-storage 400 \
    --db-instance-type db.influx.4xlarge \
    --vpc-subnet-ids subnetid1 subnetid2
    --vpc-security-group-ids mysecuritygroup \    
    --username masterawsuser \
    --password \
    --db-storage-type InfluxIOIncludedT2
```

对于 Windows：

```
aws timestream-influxdb create-db-instance \
    --name myinfluxDbinstance \
    --allocated-storage 400 \
    --db-instance-type db.influx.4xlarge \
    --vpc-subnet-ids subnetid1 subnetid2
    --vpc-security-group-ids mysecuritygroup \    
    --username masterawsuser \
    --password \
    --db-storage-type InfluxIOIncludedT2
```

 **使用 API**

要使用创建数据库实例 AWS Command Line Interface，请使用以下参数调用`CreateDBInstance`命令：

有关每项设置的信息，请参阅[数据库实例的设置](#timestream-for-influx-configuring-create-db-settings)。

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

完成适用于 InfluxDB 的 Timestream 数据库实例创建后，我们建议您下载、安装和配置 Influx CLI。

该 influx CLI 提供一种通过命令行与 InfluxDB 进行交互的简单方法。有关详细的安装和设置说明，请参阅[使用 Influx CLI](https://docs.influxdata.com/influxdb/v2/tools/influx-cli/)。

## 数据库实例的设置
<a name="timestream-for-influx-configuring-create-db-settings"></a>

您可以使用控制台、`create-db-instance` CLI 命令或 `CreateDBInstance` 适用于 InfluxDB 的 Timestream API 操作创建数据库实例。

下表提供您在创建数据库实例时所选设置的详细信息。


| 控制台设置 | 说明 | CLI 选项和 Timestream API 参数 | 
| --- | --- | --- | 
| 分配的存储空间 | 要为数据库实例分配的存储量（以 GiB 为单位）。在某些情况下，为数据库实例分配比数据库大小的存储量更高的存储量可以提高 I/O 性能。 有关更多信息，请参阅 [InfluxDB 实例存储](timestream-for-influxdb.md#timestream-for-influx-dbi-storage)。 | CLI：`allocated-storage` API：`allocatedstorage` | 
| 存储桶名称 | 用于初始化 InfluxDb 实例的存储桶的名称  | CLI：`bucket` API：`bucket` | 
| 数据库实例类型 | 数据库实例的配置。例如，db.influx.large 数据库实例类具有 16 GiB 内存，2 v，内存经过优化。CPUs 如有可能，选择足够大的数据库实例类型，以便典型查询工作集可保留在内存中。如果在内存中保留工作集，系统可以避免写入到磁盘，从而提高性能。有关更多信息，请参阅[数据库实例类类型](timestream-for-influxdb.md#timestream-for-influx-dbi-classtypes)。  | CLI：`db-instance-type` API：`Dbinstancetype` | 
| 数据库实例标识符 |  数据库实例的名称。请使用与命名本地服务器相同的方式命名数据库实例。您的数据库实例标识符最多可包含 63 个字母数字字符，并且在您选择的 AWS 区域中对于您的账户必须是唯一的。  | CLI：`db-instance-identifier` API：`Dbinstanceidentifier` | 
| 数据库参数组 | 数据库实例的参数组。您可以选择原定设置参数组，也可以创建自定义参数组。 有关更多信息，请参阅[使用数据库参数组](timestream-for-influx-db-connecting.md#timestream-for-influx-working-with-parameter-groups)。  | CLI：`db-parameter-group-name` API：`DBParameterGroupName` | 
| 日志传输设置 | 存储 InfluxDB 日志的 S3 存储桶名称。  | CLI：`LogDeliveryConfiguration` API：`log-delivery-configuration` | 
| 多可用区部署 | 创建备用实例，以在另一个可用区中创建数据库实例的被动辅助副本，从而提供故障转移支持。建议将多可用区用于生产工作负载以保持高可用性。 对于开发和测试，您可以选择不创建备用实例。 有关更多信息，请参阅[配置和管理多可用区部署](timestream-for-influx-managing-multi-az.md)。  |  CLI：`MultiAz` API：`multi-az`  | 
| 网络类型 |  数据库实例支持的 IP 寻址协议。 IPv4 （默认），指定资源只能通过 Internet 协议版本 4 (IPv4) 寻址协议与数据库实例通信。 双栈模式，用于指定资源可以通过 Internet 协议版本 6 (IPv6) 或两者兼而 IPv4有之与数据库实例通信。如果您有任何资源必须通过 IPv6 寻址协议与数据库实例通信，请使用双栈模式。此外，请确保将 IPv6 CIDR 块与您指定的数据库子网组中的所有子网相关联。虽然默认情况下 IPv6 是公开的，但我们确实支持私有 IPv6 端点，但请记住，这是一个单向门，因为我们不支持在创建实例后更改*可公开访问*标志。  |  CLI：`network-type` API：`NetworkType`  | 
| 密码 | 这将作为主用户密码，用于初始化 InfluxDB 数据库实例。您将使用此密码登录 InfluxUI 以获取运算符令牌。  | CLI：`password` API：`password` | 
| 公共访问权限 | Yes (是) 为数据库实例提供公有 IP 地址，这表示可以在 VPC 外部访问该实例。要可供公开访问，数据库实例还必须在 VPC 的公有子网中。 No 让数据库实例只在 VPC 内部是可访问的。 要从 VPC 外部连接到数据库实例，该数据库实例必须可公开访问。此外，必须使用数据库实例安全组的入站规则授予访问权限。此外，还必须满足其他要求。  | CLI：`publicly-accessible` API：`PubliclyAccessible` | 
| 存储类型 |  数据库实例的存储类型 根据工作负载要求，您可以在 3 种不同类型的预置 influx IOPS 内含存储之间进行选择： \$1 已包含 3000 IOPS 的 Influx IOPS \$1 已包含 12000 IOPS 的 Influx IOPS \$1 INflux IOPS 包括 16000 IOPS  有关更多信息，请参阅 [InfluxDB 实例存储](timestream-for-influxdb.md#timestream-for-influx-dbi-storage)。  | CLI：`db-storage-type` API：`DbStorageType` | 
| 初始用户名 | 这将作为主用户，用于初始化 InfluxDB 数据库实例。您将使用此用户名登录 InfluxUI 以获取运算符令牌。  | CLI：`username` API：`Username` | 
| 子网 | 与此数据库实例关联的 vpc 子网。  | CLI：`vpc-subnet-ids` API：`VPCSubnetIds` | 
| VPC 安全组（防火墙） | 要与数据库实例关联的安全组。  | CLI：`vpc-security-group-ids` API：`VPCSecurityGroupIds` | 