

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 3 のデータ書き込みとクエリに関するよくある質問
<a name="faq-data-operations"></a>

サポートされている APIs、クエリ言語、認証など、Amazon Timestream for InfluxDB 3 へのデータの書き込みとクエリに関する質問。詳細なガイドについては、[Timestream for InfluxDB 3 クラスターへのデータの書き込み](writing-data-to-your-influxdb-3-cluster.md)「」および「」を参照してください[Timestream for InfluxDB 3 からのデータのクエリ](querying-data-from-influxdb-3.md)。

**InfluxDB 3 にデータを書き込むにはどうすればよいですか?**  
InfluxDB 3 は、ネイティブ v3 書き込み API、InfluxDB v2 互換 API、InfluxDB v1 互換 API の複数の書き込みメソッドをサポートしています。すべてのメソッドは、行プロトコル形式を受け入れます。公式クライアントライブラリは、Python、Go、Java、JavaScript、C\# で使用できます。詳細な書き込み手順については、[InfluxDB 3 Enterprise 書き込みデータガイド](https://docs.influxdata.com/influxdb3/enterprise/write-data/)を参照してください。

**InfluxDB 3 はどのクエリ言語をサポートしていますか?**  
InfluxDB 3 は、v3 HTTP クエリ API を通じて SQL と InfluxQL をサポートします。SQL は、Apache DataFusion エンジンを搭載したプライマリクエリ言語です。InfluxQL は下位互換性のためにサポートされています。`influxdb3` CLI ツールを使用してクエリを実行することもできます。クエリ構文と例については、[InfluxDB 3 Enterprise クエリデータガイド](https://docs.influxdata.com/influxdb3/enterprise/query-data/)を参照してください。  
SQL クエリの例:  

```
SELECT time, temperature, location
FROM weather
WHERE time > now() - INTERVAL '1 hour'
ORDER BY time DESC
LIMIT 100
```

**クエリに対する認証の仕組み**  
InfluxDB 3 はトークンベースの認証を使用します。クラスターを初めてセットアップするときは、マスターユーザーアカウントとパスワードを作成します。Enterprise Edition では、アクセスレベルが異なる複数のトークンを作成できます。  
+ **管理者トークン** – CLI コマンドや API エンドポイントを含むすべてのサーバーアクションへのフルアクセスを許可します。最初に作成される管理者トークンは、完全な管理者権限を持つオペレータートークンです。
+ **リソーストークン** – 個々のデータベースやテーブルなどの特定のリソースに対する詳細なアクセス許可を付与します。データベースごとに読み取り専用、書き込み専用、または読み取り/書き込みアクセスを割り当てることができ、さまざまなアプリケーションやユーザーにきめ細かなアクセスコントロールを可能にします。
トークンは、v3 HTTP クエリ API、 `influxdb3` CLI、および v1/v2 互換 APIs。詳細については、[InfluxDB 3 Enterprise トークン管理ドキュメント](https://docs.influxdata.com/influxdb3/enterprise/admin/tokens/)を参照してください。

**データプレーンを介してデータベースとテーブルを管理することはできますか?**  
はい。InfluxDB 3 Enterprise では、CLI または HTTP API `influxdb3` を使用して、データベースとテーブルを直接作成、一覧表示、削除できます。クエリを最適化するために、Last Value キャッシュ、Distinct Value キャッシュ、カスタムファイルインデックスを管理することもできます。これらのデータプレーンオペレーションにより、 を使用せずにクラスターを管理できます AWS マネジメントコンソール。管理オペレーションの完全なリストについては、[InfluxDB 3 Enterprise 管理ガイド](https://docs.influxdata.com/influxdb3/enterprise/admin/)を参照してください。

**クエリが 401 Unauthorized エラーを返すのはなぜですか?**  
401 エラーは、認証トークンが欠落しているか、期限切れであるか、必要なアクセス許可がないことを意味します。ヘッダー (`Authorization: Bearer`または CLI の`INFLUXDB3_AUTH_TOKEN`環境変数) でトークンを渡すことを確認します。リソーストークンを使用する場合は、トークンにターゲットデータベースに対する読み取りアクセス許可があることを確認します。トークンが取り消された可能性がある場合は、トークンを再生成します。

**クエリが遅いのはなぜですか?**  
一般的な原因には、Parquet ファイルのスキャンが多すぎる ( をチェックする`query-file-limit`)、インスタンスサイズに DataFusion スレッドが不十分である、再起動後に Parquet メモリキャッシュがコールドであるなどがあります。エンタープライズクラスターの場合は、圧縮が実行されていることを確認します。圧縮しないと、小さなファイルが蓄積され、クエリのパフォーマンスが低下します。チューニングガイダンス[詳細なパラメータリファレンス](detailed-parameter-reference.md)については、「」を参照してください。

**ラインプロトコルとは**  
ラインプロトコルは、時系列データを InfluxDB に書き込むためのテキストベースの形式です。各行は、測定名、オプションのタグセット、フィールドセット、オプションのタイムスタンプを含む単一のデータポイントを表します。完全な仕様については、[InfluxDB 3 行のプロトコルリファレンス](https://docs.influxdata.com/influxdb3/enterprise/reference/line-protocol/)を参照してください。  
行プロトコルの例:  

```
weather,location=us-east,station=A1 temperature=82.0,humidity=71.2 1465839830100400200
weather,location=us-west,station=B2 temperature=68.5,humidity=45.8 1465839830100400200
```