Amazon Timestream for LiveAnalytics に類似した機能をご希望の場合は Amazon Timestream for InfluxDB をご検討ください。リアルタイム分析に適した、シンプルなデータインジェストと 1 桁ミリ秒のクエリ応答時間を特徴としています。詳細については、[こちら](https://docs.aws.amazon.com//timestream/latest/developerguide/timestream-for-influxdb.html)を参照してください。
翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Amazon Timestream for InfluxDB の DB インスタンスへの接続
DB インスタンスに接続する前に、DB インスタンスを作成する必要があります。詳細については、「[DB インスタンスの作成](timestream-for-influx-configuring.md#timestream-for-influx-configuring-create-db)」を参照してください。Amazon Timestream が DB インスタンスをプロビジョニングしたら、InfluxDB API、Influx CLI、または InfluxDB と互換性のあるクライアントもしくはユーティリティを使用して DB インスタンスに接続します。
**Topics**
+ [
## Amazon Timestream for InfluxDB の DB インスタンスの接続情報を検索する
](#timestream-for-influx-db-connecting-finding-connection-info)
+ [
## データベース認証オプション
](#timestream-for-influx-db-connecting-authentication-options)
+ [
## 「パラメータグループを使用する」
](#timestream-for-influx-parameter-groups)
## Amazon Timestream for InfluxDB の DB インスタンスの接続情報を検索する
DB インスタンスの接続情報には、エンドポイント、ポート、ユーザー名、パスワード、有効なアクセストークン (オペレータートークンまたはオールアクセストークンなど) が含まれます。例えば、Timestream for InfluxDB の DB インスタンスにおけるエンドポイントの値が `c5vasdqn0b-3ksj4dla5nfjhi.timestream-influxdb.us-east-1.on.aws` だったとします。この場合、ポート値は 8086、データベースユーザーは *admin* です。この情報から、インスタンスにアクセスするには以下を使用します。
+ インスタンスのエンドポイント `c5vasdqn0b-3ksj4dla5nfjhi.timestream-influxdb.us-east-1.on.aws:8086`。
+ インスタンスの作成時に指定されたユーザー名とパスワード、または有効なアクセストークン。
2024 年 12 月 9 日より前に作成されたインスタンスには、インスタンス ID ではなくインスタンス名を含むエンドポイントを使用します。例: `influxdb1-123456789.us-east-1.timestream-influxdb.amazonaws.com`。
**重要**
DB インスタンスのレスポンスオブジェクトの一部として、ユーザーは `influxAuthParametersSecretArn` を受け取ります。これによりアカウントの Secrets Manager シークレットに ARN が保持されます。こちらは、InfluxDB の DB インスタンスが利用できるようになった後に入力が可能になります。このシークレットには、`CreateDbInstance` プロセス中に提供される Influx の認証パラメータが含まれています。こちらは**読み取り専用**のコピーであり、このシークレットの更新/変更/削除は作成された DB インスタンスに影響しません。このシークレットを削除しても、API レスポンスは削除されたシークレット ARN を引き続き参照します。
エンドポイントは DB インスタンスごとに一意であり、ポートとユーザーの値はさまざまです。DB インスタンスに接続するときは、Influx CLI、InfluxDB API、または InfluxDB と互換性のあるクライアントを使用します。
DB インスタンスの接続情報を検索するには、 AWS マネジメントコンソールを使用します。 AWS コマンドラインインターフェイス (AWS CLI) `describe-db-instances` コマンドまたは Timestream for InfluxDB API `GetDBInstance`オペレーションを使用することもできます。
**の使用 AWS マネジメントコンソール**
1. にサインイン AWS マネジメントコンソール し、[Amazon Timestream コンソール](https://console.aws.amazon.com/timestream/)を開きます。
1. ナビゲーションペインで **[InfluxDB データベース]** を選択し、DB インスタンスのリストを表示します。
1. DB インスタンスの名前を選択して、その詳細を表示します。
1. **[概要]** セクションでエンドポイントをコピーします。また、ポート番号を書き留めます。DB インスタンスに接続するには、エンドポイントとポート番号の両方が必要です。
ユーザー名とパスワードの情報を見つける必要がある場合は、**[設定の詳細]** タブを選択し、`influxAuthParametersSecretArn` を選択して Secrets Manager にアクセスします。
**CLI の使用**
+ を使用して InfluxDB DB インスタンスの接続情報を検索するには AWS CLI、 `get-db-instance` コマンドを呼び出します。この呼び出しで、DB インスタンス 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 の使用**
1. [influx CLI](https://docs.influxdata.com/influxdb/v2/tools/influx-cli/) をまだダウンロード、インストール、設定していない場合は、それらを行います。
1. 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
```
1. [influx auth create](https://docs.influxdata.com/influxdb/v2/reference/cli/influx/auth/create/) コマンドを使用してオペレータートークンを再作成します。この処理によって古いオペレータートークンは無効になりますのでご注意ください。
```
influx auth create --org kronos --operator
```
1. オペレータートークンを取得すると、[influx auth list](https://docs.influxdata.com/influxdb/v2/reference/cli/influx/auth/list) コマンドを使用してすべてのトークンを表示することができます。[influx auth create](https://docs.influxdata.com/influxdb/v2/reference/cli/influx/auth/create/) コマンドは、オールアクセストークンの作成に使用できます。
**重要**
先にオペレータートークンを取得するには、このステップを実行する必要があります。その後、InfluxDB API または CLI を使用して新しいトークンを作成できます。
**InfluxDB UI を使用する**
1. 作成したエンドポイントを使用して Timestream for InfluxDB インスタンスを参照し、InfluxDB UI にログインしてアクセスします。InfluxDB の DB インスタンスの作成に使用した、ユーザー名とパスワードを使用する必要があります。この情報は、`CreateDbInstance` のレスポンスオブジェクトで指定された `influxAuthParametersSecretArn` から取得できます。
あるいは、InfluxDB UI を Amazon Timestream for InfluxDB コンソールから開くこともできます。
1. にサインイン AWS マネジメントコンソール し、 で Timestream for InfluxDB コンソールを開きます。 [https://console.aws.amazon.com/timestream/](https://console.aws.amazon.com/timestream/)
1. Amazon Timestream for InfluxDB コンソールの右上で、DB インスタンスを作成した AWS リージョンを選択します。
1. **[データベース]** リストで InfluxDB インスタンスの名前を選択し、詳細を表示します。右上隅で **[InfluxDB UI]** を選択します。
1. InfluxDB UI にログインしたら、左側のナビゲーションバーを使用して **[Load Data]**、**[API Tokens]** の順に移動します。
1. **[Generate API Token]** を選択し、**[All Access API Token]** を選択します。
1. API トークンの説明を入力し、**[SAVE]** を選択します。
1. 生成されたトークンをコピーし保存して、安全に保管します。
**重要**
InfluxDB UI からトークンを作成する場合、新たに作成されたトークンが表示されるのは 1 回のみです。これを忘れずにコピーしてください。さもないと、再作成が必要になります。
**InfluxDB API を使用する**
+ InfluxDB API `/api/v2/authorizations` エンドポイントに、POST リクエストメソッドを使用してリクエストを送信します。
リクエストには次の内容を含めます。
1. ヘッダー。
1. Authorization: Token
1. Content-Type: application/json
1. リクエスト本文: JSON 本文と以下のプロパティ。
1. status: "active"
1. description: API トークンの説明
1. orgID: InfluxDB 組織 ID
1. permissions: 各オブジェクトが InfluxDB リソースタイプまたは特定のリソースのアクセス許可を表すオブジェクトの配列。各アクセス許可には、以下のプロパティが含まれます。
1. action: “read” または “write”
1. resource: アクセス許可の付与先である InfluxDB リソースを表す JSON オブジェクト。各リソースには少なくともプロパティ orgID: InfluxDB 組織 ID が含まれます
1. type: リソースタイプ。どの InfluxDB リソースタイプが存在するかについての情報には、/api/v2/resources エンドポイントを使用します。
次の例では、`curl` と InfluxDB API を使用してオールアクセストークンを生成します。
```
export INFLUX_HOST=https://instanceid-123456789.timestream-influxdb.us-east-1.on.aws
export INFLUX_ORG_ID=
export INFLUX_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"}}
]
}
'
```
## データベース認証オプション
Amazon Timestream for InfluxDB では、データベースユーザーを認証する次の方法がサポートされています。
+ **パスワード認証** – DB インスタンスがユーザーアカウントのすべての管理を行います。ユーザーの作成、パスワードの指定、トークンの管理には、InfluxDB UI、Influx CLI、InfluxDB API のいずれかを使用します。
+ **パスワード認証** – ユーザーアカウントのすべての管理は DB インスタンスが行います。ユーザーの作成、パスワードの指定、トークンの管理には、Influx CLI および InfluxDB API を介してオペレータートークンを使用します。
### 暗号化された接続
アプリケーションの Secure Socket Layer (SSL) または Transport Layer Security (TLS) を使用して、DB インスタンスへの接続を暗号化できます。InfluxDB と、Kronos サービスが作成、管理するアプリケーションとの TLS ハンドシェイクに必要な証明書。証明書が更新されるとインスタンスは最新バージョンで自動的に更新されます。ユーザーによる介入は不要です。
## 「パラメータグループを使用する」
データベースパラメータは、データベースの設定方法を指定します。データベースパラメータでは、データベースに割り当てるメモリなどのリソースの量を指定できます。
DB インスタンスをパラメータグループに関連付けて、データベースの設定を管理します。Amazon Timestream for InfluxDB は、デフォルト設定でパラメータグループを定義します。カスタマイズした設定を使用して独自のパラメータグループを定義できます。
### パラメータグループの概要
DB パラメータグループは、1 つ以上の DB インスタンスに適用されるエンジン設定値のコンテナとして機能します。
**Topics**
+ [
#### デフォルトおよびカスタムパラメータグループ
](#timestream-for-influx-parameter-groups-overview-default-custom-parameter-groups)
+ [
#### DB パラメータグループを作成する
](#timestream-for-influx-parameter-groups-creating)
+ [
#### 静的および動的 DB インスタンスパラメータ
](#timestream-for-influx-parameter-groups-static-dynamic-parameters)
+ [
#### サポートされるパラメータとパラメータ値
](#timestream-for-influx-parameter-groups-overview-supported-parameters)
#### デフォルトおよびカスタムパラメータグループ
DB インスタンスでは DB パラメータグループが使用されます。次のセクションでは、DB インスタンスパラメータグループの設定と管理について説明します。
#### DB パラメータグループを作成する
AWS マネジメントコンソール、、 AWS Command Line Interfaceまたは Timestream API を使用して、新しい DB パラメータグループを作成できます。
DB パラメータグループ名には、次の制限事項が適用されます。
+ 名前は、1～255 の英字、数字、ハイフンである必要があります。
+ デフォルトのパラメータグループ名には、`default.InfluxDB.2.7` のようなピリオドを含めることができます。ただし、カスタムパラメータグループ名にはピリオドを含めることはできません。
+ 最初の文字は文字にする必要があります。
+ 名前を「dbpg-」から始めることはできません。
+ 名前の最後にハイフンを使用したり、ハイフンを 2 つ続けて使用したりすることはできません。
+ DB パラメータグループを指定せずに DB インスタンスを作成すると、DB インスタンスは InfluxDB エンジンのデフォルトを使用します。
デフォルトのパラメータグループのパラメータ設定は変更できません。代わりに、以下を実行できます。
1. 新しいパラメータグループを作成します。
1. 必要なパラメータの設定を変更します。パラメータグループ内のすべての DB エンジンパラメータが変更できるわけではありません。
1. カスタムパラメータグループを使用するように、DB インスタンスを更新します。DB インスタンスの更新方法については、「[DB インスタンスの更新](timestream-for-influx-managing-modifying-db.md)」を参照してください。
**注記**
カスタムパラメータグループを使用するように DB インスタンスを変更して DB インスタンスを起動すると、Amazon Timestream for InfluxDB は起動プロセスの一環として DB インスタンスを自動的に再起動します。
現在、カスタムパラメータグループは、一度作成すると変更ができません。パラメータを変更する必要がある場合は、新しいカスタムパラメータグループを作成し、設定変更を必要とするインスタンスにこのグループを割り当てる必要があります。既存の DB インスタンスを更新して新しいパラメータグループを割り当てると、必ずすぐに適用され、インスタンスが再起動します。
#### 静的および動的 DB インスタンスパラメータ
InfluxDB の DB インスタンスパラメータは常に静的です。これらは次のように動作します。
静的パラメータを変更し、DB パラメータグループを保存して、それをインスタンスに割り当てると、パラメータの変更はインスタンスを再起動した後に自動的に有効になります。
新しい DB パラメータグループを DB インスタンスに関連付けると、Timestream は、DB インスタンスが再起動された後にのみ、変更された静的パラメータを適用します。現在利用できるオプションは [今すぐ適用] のみです。
DB パラメータグループの変更については、「[DB インスタンスの更新](timestream-for-influx-managing-modifying-db.md)」を参照してください。
#### サポートされるパラメータとパラメータ値
DB インスタンスでサポートされているパラメータを確認するには、DB インスタンスで使用されている DB パラメータグループのパラメータを確認します。詳細については、「[DB パラメータグループのパラメータ値を表示する](#timestream-for-influx-working-with-parameter-groups-viewing)」を参照してください。
InfluxDB のオープンソースバージョンでサポートされているすべてのパラメータの詳細については、「[InfluxDB configuration options](https://docs.influxdata.com/influxdb/v2/reference/config-options/?t=JSON)」を参照してください。現在、変更できるのは次の InfluxDB パラメータのみです。
****
| パラメータ | 説明 | デフォルトの値 | 値 | 有効範囲 | メモ |
| --- | --- | --- | --- | --- | --- |
| [flux-log-enabled](https://docs.influxdata.com/influxdb/v2/reference/config-options/?t=JSON) | Flux クエリの詳細ログを表示するオプションを含めます。 | FALSE | ブール値 | 該当なし | |
| [ログレベル](https://docs.influxdata.com/influxdb/v2/reference/config-options/#log-level) | ログ出力レベル。InfluxDB は、重要度レベルが指定値以上のログエントリを出力します。 | 情報 | debug、info、error | 該当なし | |
| [no-tasks](https://docs.influxdata.com/influxdb/v2/reference/config-options/#no-tasks) | タスクスケジューラを無効にします。問題のあるタスクで InfluxDB を起動できない場合は、このオプションを使用して InfluxDB を起動します。タスクのスケジューリングや実行は行いません。 | FALSE | ブール値 | 該当なし | |
| [query-concurrency](https://docs.influxdata.com/influxdb/v2/reference/config-options/#query-concurrency) | 同時に実行できるクエリの数。0 に設定すると、同時クエリを無制限に実行できます。 | 0 | | 0～256 | |
| [query-queue-size](https://docs.influxdata.com/influxdb/v2/reference/config-options/#query-queue-size) | 実行キューで実行可能なクエリの最大数。キューが上限に達すると、新しいクエリは拒否されます。0 に設定すると、キュー内のクエリを無制限に実行できます。 | 1,024 | | 該当なし | |
| [tracing-type](https://docs.influxdata.com/influxdb/v2/reference/config-options/#tracing-type) | InfluxDB でトレースを有効にし、トレースタイプを指定します。トレースはデフォルトで無効になっています。 | "" | log、jaeger | 該当なし | |
| [metrics-disabled](https://docs.influxdata.com/influxdb/v2/reference/config-options/#metrics-disabled) | [内部 InfluxDB メトリクス](https://docs.influxdata.com/influxdb/v2/reference/internals/metrics/)を公開する HTTP/メトリクスエンドポイントを無効にします。 | FALSE | | 該当なし | |
| [http-idle-timeout](https://docs.influxdata.com/influxdb/v2/reference/config-options/#http-idle-timeout) | 新しいリクエストを待つ間、確立済みの接続をサーバーが維持する時間の長さの上限。タイムアウトがない場合は `0` に設定します。 | 3m0s | 期間 (単位: hours、minutes、seconds、milliseconds)。例: durationType=minutes,value=10 | 時間:– 最小: 0– 最大: 256,205分:– 最小: 0– 最大: 15,372,286秒:– 最小: 0– 最大: 922,337,203ミリ秒:– 最小: 0– 最大: 922,337,203,685 | |
| [http-read-header-timeout](https://docs.influxdata.com/influxdb/v2/reference/config-options/#http-read-header-timeout) | サーバーが新しいリクエストの HTTP ヘッダーの読み取りを試みる時間の長さの上限。タイムアウトがない場合は `0` に設定します。 | 10s | 期間 (単位: hours、minutes、seconds、milliseconds)。例: durationType=minutes,value=10 | 時間:– 最小: 0– 最大: 256,205分:– 最小: 0– 最大: 15,372,286秒:– 最小: 0– 最大: 922,337,203ミリ秒:– 最小: 0– 最大: 922,337,203,685 | |
| [http-read-timeout](https://docs.influxdata.com/influxdb/v2/reference/config-options/#http-read-timeout) | サーバーが新しいリクエスト全体の読み取りを試みる時間の長さの上限。タイムアウトがない場合は `0` に設定します。 | 0 | 期間 (単位: hours、minutes、seconds、milliseconds)。例: durationType=minutes,value=10 | 時間:– 最小: 0– 最大: 256,205分:– 最小: 0– 最大: 15,372,286秒:– 最小: 0– 最大: 922,337,203ミリ秒:– 最小: 0– 最大: 922,337,203,685 | |
| [http-write-timeout](https://docs.influxdata.com/influxdb/v2/reference/config-options/#http-write-timeout) | サーバーが書き込みリクエストの処理と応答に費やす時間の長さの上限。タイムアウトがない場合は `0` に設定します。 | 0 | 期間 (単位: hours、minutes、seconds、milliseconds)。例: durationType=minutes,value=10 | 時間:– 最小: 0– 最大: 256,205分:– 最小: 0– 最大: 15,372,286秒:– 最小: 0– 最大: 922,337,203ミリ秒:– 最小: 0– 最大: 922,337,203,685 | |
| [influxql-max-select-buckets](https://docs.influxdata.com/influxdb/v2/reference/config-options/#influxql-max-select-buckets) | `SELECT` ステートメントが作成できる時間バケットごとのグループの最大数。`0` の場合、バケット数に制限はありません。 | 0 | Long | 最小: 0 最大: 9,223,372,036,854,775,807 | |
| [influxql-max-select-point](https://docs.influxdata.com/influxdb/v2/reference/config-options/#influxql-max-select-point) | `SELECT` ステートメントが処理できるポイントの最大数。`0` の場合、ポイント数に制限はありません。InfluxDB はポイント数を毎秒チェックします (したがって、最大値を超えるクエリはすぐには中断しません)。 | 0 | Long | 最小: 0 最大: 9,223,372,036,854,775,807 | |
| [influxql-max-select-series](https://docs.influxdata.com/influxdb/v2/reference/config-options/#influxql-max-select-series) | `SELECT` ステートメントが返すことができる系列の最大数。`0` の場合、系列の数に制限はありません。 | 0 | Long | 最小: 0 最大: 9,223,372,036,854,775,807 | |
| [pprof-disabled](https://docs.influxdata.com/influxdb/v2/reference/config-options/#pprof-disabled) | `/debug/pprof` HTTP エンドポイントを無効にします。このエンドポイントはランタイムプロファイリングデータを提供します。こちらはデバッグの際に役立ちます。 | TRUE | ブール値 | 該当なし | InfluxDB は pprof-disabled falseをデフォルトで として設定しますが、 はそれをtrueデフォルトで として AWS 設定します。 |
| [query-initial-memory-bytes](https://docs.influxdata.com/influxdb/v2/reference/config-options/#query-initial-memory-bytes) | クエリに割り当てられるメモリの初期バイト数。 | 0 | Long | 最小: 0最大: query-memory-bytes | |
| [query-max-memory-bytes](https://docs.influxdata.com/influxdb/v2/reference/config-options/#influxql-max-select-series) | クエリに使用できるメモリの最大合計バイト数。 | 0 | Long | 最小: 0最大: 9,223,372,036,854,775,807 | |
| [query-memory-bytes](https://docs.influxdata.com/influxdb/v2/reference/config-options/#query-memory-bytes) | 新しく作成されたユーザーセッションの有効期間 (TTL) を分単位で指定します。 | 0 | Long | 最小: 0最大: 2,147,483,647 | query-initial-memory-bytes 以上にする必要があります。 |
| [session-length](https://docs.influxdata.com/influxdb/v2/reference/config-options/#session-length) | 新しく作成されたユーザーセッションの有効期間 (TTL) を分単位で指定します。 | 60 | 整数 | 最小: 0最大: 2,880 | |
| [session-renew-disabled](https://docs.influxdata.com/influxdb/v2/reference/config-options/#session-renew-disabled) | ユーザーのセッション TTL がリクエストごとに自動延長されるのを無効にします。デフォルトでは、各リクエストのセッションの有効期限は現在から 5 分後に設定されます。これを無効にした場合、セッションは指定された[セッション時間](https://docs.influxdata.com/influxdb/v2/reference/config-options/#session-length)を過ぎると有効期限が切れ、ユーザーは現在アクティブな状態であってもログインページにリダイレクトされます。 | FALSE | ブール値 | 該当なし | |
| [storage-cache-max-memory-size](https://docs.influxdata.com/influxdb/v2/reference/config-options/#storage-cache-max-memory-size) | シャードのキャッシュが書き込みの拒否を開始する前に到達できる最大サイズ (バイト単位)。 | 1,073,741,824 | Long | 最小: 0最大: 549,755,813,888 | インスタンスの合計メモリ容量より小さくする必要があります。推奨される値は、合計メモリ容量の 15% 未満です。 |
| [storage-cache-snapshot-memory-size](https://docs.influxdata.com/influxdb/v2/reference/config-options/#storage-cache-snapshot-memory-size) | ストレージエンジンがキャッシュをスナップショットし、これを TSM ファイルに書き込み、より多くのメモリを利用できるようにするサイズしきい値 (バイト単位)。 | 26,214,400 | Long | 最小: 0最大: 549,755,813,888 | storage-cache-max-memory-size より小さくする必要があります。 |
| [storage-cache-snapshot-write-cold-duration](https://docs.influxdata.com/influxdb/v2/reference/config-options/#storage-cache-snapshot-write-cold-duration) | シャードが書き込みまたは削除を受信していない場合に、ストレージエンジンがキャッシュをスナップショットし、新しい TSM ファイルに書き込む時間しきい値。 | 10m0s | 期間 (単位: hours、minutes、seconds、milliseconds)。例: durationType=minutes,value=10 | 時間:– 最小: 0– 最大: 256,205分:– 最小: 0– 最大: 15,372,286秒:– 最小: 0– 最大: 922,337,203ミリ秒:– 最小: 0– 最大: 922,337,203,685 | |
| [storage-compact-full-write-cold-duration](https://docs.influxdata.com/influxdb/v2/reference/config-options/#storage-compact-full-write-cold-duration) | シャードが書き込みまたは削除を受信していない場合に、ストレージエンジンがすべての TSM ファイルを圧縮する時間しきい値。 | 4h0m0s | 期間 (単位: hours、minutes、seconds、milliseconds)。例: durationType=minutes,value=10 | 時間:– 最小: 0– 最大: 256,205分:– 最小: 0– 最大: 15,372,286秒:– 最小: 0– 最大: 922,337,203ミリ秒:– 最小: 0– 最大: 922,337,203,685 | |
| [storage-compact-throughput-burst](https://docs.influxdata.com/influxdb/v2/reference/config-options/#storage-compact-throughput-burst) | TSM 圧縮がディスクに書き込むことができるレートの上限 (バイト/秒)。 | 50,331,648 | Long | 最小: 0最大: 9,223,372,036,854,775,807 | |
| [storage-max-concurrent-compactions](https://docs.influxdata.com/influxdb/v2/reference/config-options/#storage-max-concurrent-compactions) | 同時に実行できる完全圧縮とレベル圧縮の最大数。`0` にすると、ランタイムに使用される `runtime.GOMAXPROCS(0)` の 50% になります。ゼロより大きい値に設定すると、圧縮はその値に制限されます。この設定は、キャッシュのスナップショット作成には適用されません。 | 0 | 整数 | 最小: 0最大: 64 | |
| [storage-max-index-log-file-size](https://docs.influxdata.com/influxdb/v2/reference/config-options/#storage-max-index-log-file-size) | インデックス先行書き込みログ (WAL) ファイルがインデックスファイルに圧縮されるサイズしきい値 (バイト単位)。サイズを小さくするとログファイルはより短い時間で圧縮され、書き込みスループットを犠牲にしてヒープ使用量が減少します。 | 1,048,576 | Long | 最小: 0最大: 9,223,372,036,854,775,807 | |
| [storage-no-validate-field-size](https://docs.influxdata.com/influxdb/v2/reference/config-options/#storage-no-validate-field-size) | 受信する書き込みリクエストのフィールドサイズ検証を省略します。 | FALSE | ブール値 | 該当なし | |
| [storage-retention-check-interval](https://docs.influxdata.com/influxdb/v2/reference/config-options/#storage-retention-check-interval) | 保持ポリシーの強制適用チェックの間隔。 | 30m0s | 期間 (単位: hours、minutes、seconds、milliseconds)。例: durationType=minutes,value=10 | 該当なし | 時間:– 最小: 0– 最大: 256,205分:– 最小: 0– 最大: 15,372,286秒:– 最小: 0– 最大: 922,337,203ミリ秒:– 最小: 0– 最大: 922,337,203,685 |
| [storage-series-file-max-concurrent-snapshot-compactions](https://docs.influxdata.com/influxdb/v2/reference/config-options/#storage-series-file-max-concurrent-snapshot-compactions) | データベース内のすべての系列パーティションで同時に実行できるスナップショット圧縮の最大数。 | 0 | 整数 | 最小: 0最大: 64 | |
| [storage-series-id-set-cache-size](https://docs.influxdata.com/influxdb/v2/reference/config-options/#storage-series-id-set-cache-size) | あらかじめ計算された系列結果を保存するために TSI インデックスで使用される内部キャッシュのサイズ。キャッシュされた結果はすばやく返されて、同じタグキー/値の述語を持つ後続のクエリが実行されたときに再計算する必要はありません。この値を `0` に設定するとキャッシュが無効になり、クエリのパフォーマンスが低下する可能性があります。 | 100 | Long | 最小: 0最大: 9,223,372,036,854,775,807 | |
| [storage-wal-max-concurrent-writes](https://docs.influxdata.com/influxdb/v2/reference/config-options/#storage-wal-max-concurrent-writes) | 同時に試行される WAL ディレクトリへの書き込みの最大数。 | 0 | 整数 | 最小: 0最大: 256 | |
| [storage-wal-max-write-delay](https://docs.influxdata.com/influxdb/v2/reference/config-options/#storage-wal-max-write-delay) | WAL ディレクトリへの同時アクティブ書き込みが最大数に達したときに、WAL ディレクトリへの書き込みリクエストが待機する最大時間。`0` に設定するとタイムアウトが無効になります。 | 10m | 期間 (単位: hours、minutes、seconds、milliseconds)。例: durationType=minutes,value=10 | 時間:– 最小: 0– 最大: 256,205分:– 最小: 0– 最大: 15,372,286秒:– 最小: 0– 最大: 922,337,203ミリ秒:– 最小: 0– 最大: 922,337,203,685 | |
| [ui-disabled](https://docs.influxdata.com/influxdb/v2/reference/config-options/#ui-disabled) | InfluxDB ユーザーインターフェイス (UI) を無効にします。この UI はデフォルトで有効になっています。 | FALSE | ブール値 | 該当なし | |
パラメータグループに不適切な設定のパラメータがあると、パフォーマンスが低下したりシステムが不安定になったり、予期しない悪影響が生じることがあります。データベースのパラメータを変更するときは、常に注意してください。テスト DB インスタンスでパラメータグループの設定の変更をテストしてから、本番稼働用 DB インスタンスにそれらの変更を適用してください。
### DB パラメータグループを使用する
DB インスタンスでは DB パラメータグループが使用されます。次のセクションでは、DB インスタンスパラメータグループの設定と管理について説明します。
**Topics**
+ [
#### DB パラメータグループを作成する
](#timestream-for-influx-working-with-parameter-groups-creating)
+ [
#### DB パラメータグループを DB インスタンスに関連付ける
](#timestream-for-influx-working-with-parameter-groups-associating)
+ [
#### DB パラメータグループを一覧表示する
](#timestream-for-influx-working-with-parameter-groups-listing)
+ [
#### DB パラメータグループのパラメータ値を表示する
](#timestream-for-influx-working-with-parameter-groups-viewing)
#### DB パラメータグループを作成する
**の使用 AWS マネジメントコンソール**
1. にサインイン AWS マネジメントコンソール し、[Amazon Timestream for InfluxDB コンソール](https://console.aws.amazon.com/timestream/)を開きます。
1. ナビゲーションペインで、**[パラメータグループ]** を選択します。
1. **[パラメータグループの作成]** を選択します。
1. **[パラメータグループ名]** の欄に、新しい DB パラメータグループの名前を入力します。
1. [**説明**] ボックスに、新しい DB パラメータグループの説明を入力します。
1. 変更するパラメータを選択し、希望する値を適用します。サポートされているパラメータの詳細については、「[サポートされるパラメータとパラメータ値](#timestream-for-influx-parameter-groups-overview-supported-parameters)」を参照してください。
1. **[パラメータグループの作成]** を選択します。
**の使用 AWS Command Line Interface**
+ CLI を使用して DB AWS パラメータグループを作成するには、次のパラメータを指定して `create-db-parameter-group` コマンドを呼び出します。
```
--db-parameter-group-name
--description
--endpoint_url
--region
--parameters (list) (string)
```
**Example 例**
各設定の詳細については、「[DB インスタンスの設定](timestream-for-influx-configuring.md#timestream-for-influx-configuring-create-db-settings)」を参照してください。この例では、デフォルトのエンジン設定を使用します。
```
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
```
#### DB パラメータグループを DB インスタンスに関連付ける
カスタマイズした設定を使用して、独自の DB パラメータグループを作成できます。DB パラメータグループを DB インスタンスに関連付けるには AWS マネジメントコンソール、、 AWS Command Line Interface、または Timestream for InfluxDB API を使用します。DB インスタンスを作成または変更するときに、これを行うことができます。
DB パラメータグループの作成については、[DB パラメータグループを作成する](#timestream-for-influx-working-with-parameter-groups-creating) を参照してください。DB インスタンスの作成については、「[DB インスタンスの作成](timestream-for-influx-configuring.md#timestream-for-influx-configuring-create-db)」を参照してください。DB インスタンスの変更については、[DB インスタンスの更新](timestream-for-influx-managing-modifying-db.md)を参照してください。
**注記**
新しい DB パラメータグループを DB インスタンスに関連付ける場合、変更された静的パラメータは、DB インスタンスが再起動された後にのみ適用されます。現在サポートされているのは [今すぐ適用] のみです。Timestream for InfluxDB がサポートしているのは静的パラメータのみです。
**の使用 AWS マネジメントコンソール**
1. にサインイン AWS マネジメントコンソール し、[Amazon Timestream for InfluxDB コンソール](https://console.aws.amazon.com/timestream/)を開きます。
1. ナビゲーションペインで、**[InfluxDB データベース]** を選択し、次に変更する DB インスタンスを選択します。
1. **[更新]** を選択します。**[DB インスタンスを更新]** ページが表示されます。
1. **DB パラメータグループ**の設定を変更します。
1. [**Continue**] を選択して、変更の概要を確認します。
1. 現在サポートされているのは **[今すぐ適用]** のみです。このオプションにより DB インスタンスが再起動するため、処理が中断する場合があります。
1. 確認ページで、変更内容を確認します。内容が正しければ、**[DB インスタンスを更新]** を選択して変更を保存し、適用します。または、[**戻る**] を選択して変更を編集するか、**キャンセル**を選択して変更をキャンセルします。
**の使用 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 }}"
```
#### DB パラメータグループを一覧表示する
AWS アカウント用に作成した DB パラメータグループを一覧表示できます。
**の使用 AWS マネジメントコンソール**
1. にサインイン AWS マネジメントコンソール し、[Amazon Timestream for InfluxDB コンソール](https://console.aws.amazon.com/timestream/)を開きます。
1. ナビゲーションペインで、[**パラメータグループ**] を選択します。
1. DB パラメータグループがリストに表示されます。
**の使用 AWS Command Line Interface**
AWS アカウントのすべての DB パラメータグループを一覧表示するには AWS Command Line Interface 、 `list-db-parameter-groups` コマンドを使用します。
```
aws timestream-influxdb list-db-parameter-groups --region region
```
AWS アカウントの特定の DB パラメータグループを返すには、 `get-db-parameter-group` コマンドを使用します AWS Command Line Interface 。
```
aws timestream-influxdb get-db-parameter-group --region region --identifier identifier
```
#### DB パラメータグループのパラメータ値を表示する
DB パラメータグループのすべてのパラメータとそれらの値のリストを取得できます。
**の使用 AWS マネジメントコンソール**
1. にサインイン AWS マネジメントコンソール し、[Amazon Timestream for InfluxDB コンソール](https://console.aws.amazon.com/timestream/)を開きます。
1. ナビゲーションペインで、[**パラメータグループ**] を選択します。
1. DB パラメータグループがリストに表示されます。
1. パラメータを一覧表示するパラメータグループの名前を選択します。
**の使用 AWS Command Line Interface**
DB パラメータグループのパラメータ値を表示するには、 コマンドを使用します AWS Command Line Interface `get-db-parameter-group`。*parameter-group-identifier* を自分の情報に置き換えます。
```
get-db-parameter-group --identifier parameter-group-identifier
```
**API の使用**
DB パラメータグループのパラメータ値を表示するには、Timestream API の `GetDbParameterGroup` コマンドを使用します。*parameter-group-identifier* を自分の情報に置き換えます。
```
GetDbParameterGroup parameter-group-identifier
```