View a markdown version of this page

Amazon Timestream for InfluxDB 3 のデータ書き込みとクエリに関するよくある質問 - Amazon Timestream

Amazon Timestream for LiveAnalytics に類似した機能をご希望の場合は Amazon Timestream for InfluxDB をご検討ください。リアルタイム分析に適した、シンプルなデータインジェストと 1 桁ミリ秒のクエリ応答時間を特徴としています。詳細については、こちらを参照してください。

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

Amazon Timestream for InfluxDB 3 のデータ書き込みとクエリに関するよくある質問

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

InfluxDB 3 にデータを書き込むにはどうすればよいですか?

InfluxDB 3 は、ネイティブ v3 書き込み API、InfluxDB v2 互換 API、InfluxDB v1 互換 API の複数の書き込みメソッドをサポートしています。すべてのメソッドは、行プロトコル形式を受け入れます。公式クライアントライブラリは、Python、Go、Java、JavaScript、C# で使用できます。詳細な書き込み手順については、InfluxDB 3 Enterprise 書き込みデータガイドを参照してください。

InfluxDB 3 はどのクエリ言語をサポートしていますか?

InfluxDB 3 は、v3 HTTP クエリ API を通じて SQL と InfluxQL をサポートします。SQL は、Apache DataFusion エンジンを搭載したプライマリクエリ言語です。InfluxQL は下位互換性のためにサポートされています。influxdb3 CLI ツールを使用してクエリを実行することもできます。クエリ構文と例については、InfluxDB 3 Enterprise クエリデータガイドを参照してください。

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 トークン管理ドキュメントを参照してください。

データプレーンを介してデータベースとテーブルを管理することはできますか?

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

クエリが 401 Unauthorized エラーを返すのはなぜですか?

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

クエリが遅いのはなぜですか?

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

ラインプロトコルとは

ラインプロトコルは、時系列データを InfluxDB に書き込むためのテキストベースの形式です。各行は、測定名、オプションのタグセット、フィールドセット、オプションのタイムスタンプを含む単一のデータポイントを表します。完全な仕様については、InfluxDB 3 行のプロトコルリファレンスを参照してください。

行プロトコルの例:

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