Amazon Timestream for LiveAnalytics に類似した機能をご希望の場合は Amazon Timestream for InfluxDB をご検討ください。リアルタイム分析に適した、シンプルなデータインジェストと 1 桁ミリ秒のクエリ応答時間を特徴としています。詳細については、[こちら](https://docs.aws.amazon.com//timestream/latest/developerguide/timestream-for-influxdb.html)を参照してください。

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Timestream for InfluxDB リードレプリカクラスターの作成
<a name="timestream-for-influx-create-rr-cluster"></a>

Timestream for InfluxDB リードレプリカクラスターには、ライター DB インスタンスとリーダー DB インスタンスが 1 つずつあり、それぞれ異なるアベイラビリティーゾーンに置かれています。Timestream for InfluxDB リードレプリカクラスターは、高可用性を実現し、読み取りワークロードの容量がこれまでより増加している他、レプリカのフェイルオーバーを設定するとフェイルオーバーを高速化できます。

## DB クラスターの前提条件
<a name="timestream-for-influx-create-prereq"></a>

**重要**  
リードレプリカクラスターを作成するときは、次の前提条件を満たしておく必要があります。

**Topics**
+ [DB クラスターのネットワークを設定する](#timestream-for-influx-config-network)
+ [追加の前提条件](#timestream-for-influx-addl-prereqs)

### DB クラスターのネットワークを設定する
<a name="timestream-for-influx-config-network"></a>

Timestream for InfluxDB リードレプリカ DB クラスターを作成できるのは、Amazon VPC サービスを基盤とする仮想プライベートクラウド (VPC) の中のみです。少なくとも 3 つのアベイラビリティーゾーン AWS リージョン がある に存在する必要があります。DB クラスターで選択する DB サブネットグループは、少なくとも 3 つのアベイラビリティーゾーンを対象とする必要があります。この設定により、DB クラスターの各 DB インスタンスが別のアベイラビリティーゾーンに配置されます。

同じ VPC 内の EC2 インスタンス以外のリソースから DB クラスターに接続するには、ネットワーク接続を手動で設定します。

### 追加の前提条件
<a name="timestream-for-influx-addl-prereqs"></a>

**リードレプリカクラスターを作成するときは、以下の追加の前提条件を考慮に入れます。**

DB クラスターの設定パラメータを調整するには、必要なパラメータ設定を持つ DB クラスターパラメータグループを指定します。DB クラスターのパラメータグループの作成または変更については、「[リードレプリカクラスターのパラメータグループ](timestream-for-influx-working-read-replica.md#timestream-for-influx-rr-param-groups) 」を参照してください。

DB クラスター用に指定する TCP/IP ポート番号を確認します。一部の会社のファイアウォールによっては、デフォルトポートへの接続がブロックされます。会社のファイアウォールがデフォルトのポートをブロックする場合は、お客様の DB クラスター用に別のポートを選択します。DB クラスター内のすべての DB インスタンスは、同じポートを使用します。

## DB クラスターを作成する
<a name="timestream-for-influx-create-cluster"></a>

InfluxDB リードレプリカ DB クラスターの Timestream は AWS マネジメントコンソール、、 AWS CLI、または Amazon Timestream for InfluxDB API を使用して作成できます。

------
#### [ Using the AWS マネジメントコンソール ]

Timestream for InfluxDB リードレプリカ DB クラスターは、**[デプロイ設定]** セクションで **[リードレプリカを持つクラスター]** を選択して作成します。

コンソールを使用してリードレプリカ DB クラスターを作成する手順:

1. [AWS マネジメントコンソール](https://console.aws.amazon.com/timestream)にサインインし、Amazon Timestream のコンソールを開きます。

1. の右上隅 AWS リージョン で AWS マネジメントコンソール、リードレプリカ DB クラスターを作成する を選択します。

1. ナビゲーションペインで、**[InfluxDB データベース]** を選択します。

1. **[InfluxDB データベースを作成]** を選択します。

1. **[デプロイ設定]** で、**[リードレプリカを持つクラスター]** を選択します。

   そのオプションを選択すると、 AWS Marketplace ウィジェットを介してサブスクリプションをアクティブ化する必要があることを示すメッセージが表示されます。**[購読オプションを見る]** をクリックします。サブスクリプションがアクティブになるまでに 1～2 分かかる場合があります。  
![新しいデータベースで使用できるさまざまなデプロイ設定が表示された [InfluxDB データベースを作成] のインターフェイス。リードレプリカオプションを持つクラスターが選択されている。](http://docs.aws.amazon.com/ja_jp/timestream/latest/developerguide/images/kronos/deployment_settings_rr.jpg)  
![サブスクリプションが進行中であることを伝えるメッセージが表示された [デプロイ設定] のインターフェイス。](http://docs.aws.amazon.com/ja_jp/timestream/latest/developerguide/images/kronos/subscription_in_progress.jpg)

1. サブスクリプションがアクティブになったら、**[サブスクリプションを表示]** をクリックします。  
![サブスクリプションがアクティブになったことを伝えるメッセージが表示された [デプロイ設定] のインターフェイス。](http://docs.aws.amazon.com/ja_jp/timestream/latest/developerguide/images/kronos/subscription_success_message.jpg)

1. 各リージョンの vCPU あたり、インスタンス時間あたりのコストに関する情報を示すウィンドウが表示されます。このコストには、選択したインスタンスタイプに基づき、インスタンスがアクティブになっている時間に応じて課金されるモデルと同じ、コンピューティング料金モデルが使用されます。アドオンをサブスクライブするのは 1 回のみです。これで、Timestream for InfluxDB を利用できるすべてのリージョンにインスタンスを作成できます。  
![各リージョンの vCPU あたり、インスタンス時間あたりのコストに関する料金詳細が表示されたサブスクリプションオプションのフォーム。](http://docs.aws.amazon.com/ja_jp/timestream/latest/developerguide/images/kronos/purchase_subscription.png)
**重要**  
オファーをサブスクライブするには、AWSMarketplaceManageSubscriptions または AWSMarketplaceFullAccess アクセス許可が必要になります。これらのアクセス許可の詳細については、[AWS Marketplace 「サブスクリプションへのアクセスの制御](https://docs.aws.amazon.com/marketplace/latest/buyerguide/buyer-iam-users-groups-policies.html)」を参照してください。

1. サブスクリプションを確定すると、お使いのインスタンスのリージョンに基づいて、リージョンが自動的に選択されます。

1. **[データベース認証情報]** で、次の欄に入力します。

   1. **[DB クラスター名]** に DB クラスターの名前を入力します。

   1. InfluxDB の初期設定パラメータとして **[ユーザー名]**、**[組織名]**、**[バケット名]**、**[パスワード]** を入力します。

1. **[インスタンス設定]** で、**[DB インスタンスクラス]** を指定します。ワークロードのニーズに最も適したインスタンスサイズを選択します。このインスタンスタイプは、お使いのリードレプリカ DB クラスター内のすべてのインスタンスに使用されますのでご注意ください。

1. **[ストレージ設定]** で、ご自身のニーズに適した **[ストレージタイプ]** を選択します。いずれの場合も、割り当てられたストレージを設定するだけです。このストレージタイプは、お使いのリードレプリカ DB クラスター内のすべてのインスタンスに使用されますのでご注意ください。

1. **[接続設定]** セクションで、InfluxDB クラスターが、Timestream for InfluxDB の DB インスタンスへの接続を必要とするクライアントと同じサブネットにあることを確認します。**[パブリックアクセス]** サブセクションで DB インスタンスを一般に公開するように選択することもできます。

1. **[InfluxDB データベースを作成]** を選択します。

1. **[InfluxDB データベース]** リストで、新しい InfluxDB クラスターの名前を選択し、詳細を表示します。DB クラスターのステータスは、使用可能になるまでは **[作成中]** と表示されます。

1. ステータスが **[利用可能]** に変わったら、DB クラスターに接続できます。DB インスタンスクラスとストレージの合計によっては、新しいインスタンスを使用できるようになるまで最長 20 分かかることがあります。  
![DB クラスターの概要ページ。2 つのインスタンスのステータスは [利用可能] と表示されている。](http://docs.aws.amazon.com/ja_jp/timestream/latest/developerguide/images/kronos/cluster_details_page.png)

1. クラスターが作成されると、DB クラスターの ID をクリックすることで新たに作成したクラスターの情報を取得できます。インスタンスモードが **PRIMARY** と表示されているエンドポイントは、書き込みとエンジン管理に使用すべきエンドポイントです。

------
#### [ Using the AWS CLI ]

を使用して DB インスタンスを作成するには AWS Command Line Interface、次のパラメータを指定して `create-db-cluster` コマンドを呼び出します。各{{ユーザー入力プレースホルダー}}を独自の情報に置き換えます。

```
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.
```

------

### リードレプリカクラスターを作成する際の設定
<a name="timestream-for-influx-rr-create-settings"></a>

リードレプリカクラスターを作成する際に選択する設定の詳細については、次の表を参照してください。 AWS CLI オプションの詳細については、「[create-db-cluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/timestream-influxdb/create-db-cluster.html)」を参照してください。Amazon Timestream for InfluxDB API パラメータの詳細については、「[CreateDbCluster](https://docs.aws.amazon.com/ts-influxdb/latest/ts-influxdb-api/API_CreateDbCluster.html)」を参照してください。


****  

| コンソール設定 | 設定の説明 | CLI オプションと Timestream for InfluxDB の API パラメータ | 
| --- | --- | --- | 
| ストレージ割り当て | DB クラスターのそれぞれの DB インスタンスに割り当てるストレージの量 (ギビバイト単位)。詳細については、「[InfluxDB インスタンスストレージ](timestream-for-influxdb.md#timestream-for-influx-dbi-storage)」を参照してください。 | **CLI オプション: **`--allocated-storage`<br />**API パラメータ: **`allocatedStorage` | 
| データベースポート | InfluxDB が接続を受け入れるポート番号。<br />有効な値: 1024～65535<br />デフォルト: 8086<br />制限: 値は 2375～2376、7788～7799、8090、51678～51680 にすることはできません。 | **CLI オプション: **`--port`<br />**API パラメータ: **`port` | 
| DB クラスター名 | DB クラスターを一意に識別する名前。DB インスタンス名は、ユーザーごとおよびリージョンごとに一意にする必要があります。 | **CLI オプション: **`--name`<br />**API パラメータ: **`name` | 
| DB インスタンスのタイプ | Timestream for InfluxDB の DB クラスターにおける各 DB インスタンスのコンピューティング容量とメモリ容量 (db.influx.xlarge など)。可能であれば、一般的なクエリの作業セットをメモリに保持できる十分な大きさの DB インスタンスクラスを選択します。作業セットがメモリに保持されていると、システムによるディスクへの書き込みが回避され、これによりパフォーマンスが向上します。 | **CLI オプション: **`--db-instance-type`<br />**API パラメータ: **`dbInstanceType` | 
| DB クラスターのパラメータグループ |  DB クラスターに割り当てる DB パラメータグループの ID。DB パラメータグループは、データベースの設定方法を指定します。例えば、DB パラメータグループを使うことでクエリの同時実行数の上限を指定できます。 | **CLI オプション: **`--db-parameter-group-identifier`<br />**API パラメータ: **`dbParameterGroupIdentifier` | 
| デプロイタイプ | DB クラスターをマルチノードのリードレプリカとしてデプロイするか、マルチ AZ マルチノードリードレプリカとしてデプロイするかを指定します。<br />使用できる値: `MULTI_NODE_READ_REPLICAS` | **CLI オプション: **`--deployment-type`<br />**API パラメータ: **`deploymentType` | 
| VPC サブネット ID | DB クラスターに使用する DB サブネットの ID。既存の DB サブネットグループを使用する [既存のグループを選択] を選択し、次に [既存の DB サブネットグループ] のドロップダウンリストから必要なサブネットグループを選択します。Timestream for InfluxDB が互換性のある DB サブネットグループを選択できるように、[自動セットアップ] を選択します。 | **CLI オプション: **`--vpc-subnet-ids`<br />**API パラメータ: **`vpcSubnetIds` | 
| 組織 | InfluxDB における最初の管理者ユーザーが使用する最初の組織の名前。InfluxDB 組織はユーザーグループ向けのワークスペースです。 | **CLI オプション: **`--organization`<br />**API パラメータ: **`organization` | 
| バケット | 初期 InfluxDB バケットの名前。InfluxDB のデータはすべてバケットに保存されます。バケットは、データベースの概念と保持期間 (各データポイントが保持される期間) を組み合わせたものです。バケットは組織に属します。 | **CLI オプション: **`--bucket`<br />**API パラメータ: **`bucket` | 
| ログのエクスポート | InfluxDB エンジンログを指定された S3 バケットに送信するための設定。<br />S3 バケットのログ配信の設定: `s3Configuration -> (structure)`<br />ログの送信先となる S3 バケットの名前: `bucketName -> (string)`<br />S3 バケットへのログ記録が有効になっているかどうかを示す: `enabled -> (boolean)`<br />短縮構文: `s3Configuration={bucketName=string, enabled=boolean}` | **CLI オプション: **`--log-delivery-configuration`<br />**API パラメータ: **`logDeliveryConfiguration` | 
| [パスワード] | InfluxDB に作成した最初の管理者ユーザーのパスワード。このパスワードにより、InfluxDB UI にアクセスしてさまざまな管理タスクを実行できます。また、InfluxDB CLI を使用してオペレータートークンを作成することもできます。これらの属性は、アカウントの AWS Secrets Manager に作成されたシークレットに保存されます。 | **CLI オプション: **`--password`<br />**API パラメータ: **`password` | 
| ユーザー名 | InfluxDB に作成した最初の管理者ユーザーのユーザー名。名前は文字から開始します。名前の終わりにハイフンを 1 つ使用したり、ハイフンを 2 つ続けて使用したりすることはできません。my-user1 のようにします。このユーザー名により、InfluxDB UI にアクセスしてさまざまな管理タスクを実行できます。また、InfluxDB CLI を使用してオペレータートークンを作成することもできます。これらの属性は、アカウントの AWS Secrets Manager に作成されたシークレットに保存されます。 | **CLI オプション: **`--username`<br />**API パラメータ: **`username` | 
| パブリックアクセス | DB クラスターに VPC の外部からアクセスできるかどうかを示します。**[パブリックアクセス可能]** の場合、DB クラスターにパブリック IP アドレスが付与され、VPC の外部からアクセスできます。パブリックにアクセス可能となるよう、DB クラスターは、VPC のパブリックサブネット内にある必要があります。<br />**[パブリックアクセス不可]** の場合、DB クラスターには VPC の内部からしかアクセスできません。 | **CLI オプション: **`--publicly-accessible``--no-publicly-accessible`<br />**API パラメータ: **`publiclyAccessible` | 
| DB storage type | InfluxDB のデータ。ワークロードの要件に応じて、3 種類のプロビジョニング済み Influx IOPS 込みストレージの中から選択できます。<br />使用できる値:[See the AWS documentation website for more details](http://docs.aws.amazon.com/ja_jp/timestream/latest/developerguide/timestream-for-influx-create-rr-cluster.html) | **CLI オプション: **`--db-storage-type``--no-publicly-accessible`<br />**API パラメータ: **`dbStorageType` | 
| VPC セキュリティグループ | DB インスタンスに割り当てる VPC セキュリティグループ ID のリスト。 | **CLI オプション: **`--vpc-security-group-ids``--no-publicly-accessible`<br />**API パラメータ: **`vpcSecurityGroupIds` | 
| VPC サブネット ID | DB インスタンスに関連付ける VPC サブネット ID のリスト。Timestream for InfluxDB の DB クラスターを使用してデプロイするときは、各アベイラビリティーゾーンに 2 つ以上の VPC サブネット ID を指定します。 | **CLI オプション: **`--vpc-subnet-ids`<br />**API パラメータ: **`vpcSubnetIds` | 
| フェイルオーバーモード | プライマリインスタンスの障害に対するクラスターの応答方法。このモードは次のオプションを使って設定します。`AUTOMATIC`: プライマリインスタンスに障害が発生すると、システムはリードレプリカを自動的に新しいプライマリインスタンスに昇格させます。<br />`NO_FAILOVER`: プライマリインスタンスに障害が発生すると、システムは、リードレプリカを昇格させることなく、プライマリインスタンスの復元を試みます。プライマリインスタンスが復元するまでクラスターは使用できなくなります。 | **CLI オプション: **`--failover-mode`<br />**API パラメータ: **`failoverMode` | 

**重要**  
DB クラスターの応答オブジェクトの一部として、ユーザーは `influxAuthParametersSecretArn` を受け取ります。これにより、ARN はアカウントの Secrets Manager シークレットに保持されます。こちらは InfluxDB の DB インスタンスが利用できるようになった後に入力されます。このシークレットには、`CreateDbInstance` プロセス中に提供される Influx の認証パラメータが含まれています。こちらは**読み取り専用**のコピーであり、このシークレットの更新/変更/削除は作成された DB インスタンスに影響しません。このシークレットを削除しても、API レスポンスは削除されたシークレット ARN を引き続き参照します。