メインコンテンツまでスキップ
メインコンテンツまでスキップ

quick-start

概要​

ClickHouseのセットアップを迅速に行います。オペレーティングシステムに適したバイナリをダウンロードし、ClickHouseサーバーを起動し、テーブルを作成してデータを挿入し、ClickHouseクライアントを使用してテーブルをクエリします。

前提条件​

ClickHouseバイナリを取得するために、curlまたは他のコマンドラインHTTPクライアントが必要です。

バイナリのダウンロード​

ClickHouseは、Linux、FreeBSD、macOS上でネイティブに動作し、WindowsではWSLを介して動作します。ClickHouseをローカルにダウンロードする最も簡単な方法は、以下のcurlコマンドを実行することです。このコマンドは、使用しているオペレーティングシステムがサポートされているかどうかを判断し、適切なClickHouseバイナリをダウンロードします。

注記

以下のコマンドは、新しく空のサブディレクトリで実行することをお勧めします。なぜなら、ClickHouseサーバーが初めて実行されるときに、そのバイナリが存在するディレクトリにいくつかの構成ファイルが作成されるからです。

次のような表示がされます:

この段階では、installコマンドを実行するように促されても無視してかまいません。

注記

Macユーザーへ: バイナリの開発者が確認できないというエラーが表示される場合は、"macOSでの開発者確認エラーを修正する方法"を参照してください。

サーバーを起動する​

以下のコマンドを実行して、ClickHouseサーバーを起動します:

ターミナルにログが表示され始めるはずです。これは期待される動作です。ClickHouseでは、デフォルトのログレベルがtraceに設定されています。

クライアントを起動する​

clickhouse-clientを使用してClickHouseサービスに接続します。新しいターミナルを開き、clickhouseバイナリが保存されているディレクトリに移動し、次のコマンドを実行します:

サービスに接続すると、以下のように笑顔の絵文字が表示されるはずです:

テーブルを作成する​

CREATE TABLEを使用して新しいテーブルを定義します。典型的なSQL DDLコマンドはClickHouseでも動作しますが、一つだけ追加があります - ClickHouseのテーブルにはENGINE句が必要です。MergeTreeを使用して、ClickHouseのパフォーマンスの利点を活用します:

データを挿入する​

ClickHouseでは、既知のINSERT INTO TABLEコマンドを使用できますが、MergeTreeテーブルへの各挿入が、ClickHouse内でパーツが作成されることを理解することが重要です。これらのパーツは、後でClickHouseによってバックグラウンドでマージされます。

ClickHouseでは、一度に大量の行（数万行または数百万行）をバルク挿入して、バックグラウンドプロセスでマージされる必要があるパーツの数を最小限に抑えようとしています。

このガイドでは、それを心配する必要はありません。以下のコマンドを実行して、テーブルに数行のデータを挿入します:

新しいテーブルをクエリする​

他のSQLデータベースと同様に、SELECTクエリを書くことができます:

結果が美しいテーブル形式で返されることに気付くでしょう:

自分のデータを挿入する​

次のステップは、自分のデータをClickHouseに入れることです。我々はデータを取り込むためにたくさんのテーブル関数や統合を持っています。下のタブにはいくつかの例がありますが、ClickHouseと統合する技術の長いリストをチェックするために、統合のページを確認することもできます。

s3テーブル関数を使用して、S3からファイルを読み取ります。これはテーブル関数であり、結果は次のように使うことができます:

  1. SELECTクエリのソースとして使用する（データをS3に保ちながら即席のクエリを実行可能）、または...
  2. 結果のテーブルをMergeTreeテーブルに挿入する（ClickHouseにデータを移動する準備ができたとき）

即席のクエリの例は次のようになります:

データをClickHouseテーブルに移動する場合は、次のようになります。ここで、nyc_taxiはMergeTreeテーブルです:

ClickHouseとS3を使用するための詳細および例については、AWS S3ドキュメントページのコレクションを参照してください。


次のステップ​

  • コアコンセプトセクションをチェックして、ClickHouseの基本的な仕組みについて学んでください。
  • 高度なチュートリアルをチェックして、ClickHouseの主要な概念と機能に深く掘り下げてください。
  • ClickHouse Academyで、無料のオンデマンドトレーニングコースを受講して学び続けてください。
  • 挿入方法の指示が含まれた例データセットのリストがあります。
  • 外部ソースからデータが来ている場合、メッセージキュー、データベース、パイプラインなどへの接続のための統合ガイドのコレクションを参照してください。
  • UI/BIビジュアリゼーションツールを使用している場合は、ClickHouseへのUI接続のユーザーガイドを確認してください。
  • 主キーに関するユーザーガイドでは、主キーに関するすべてと、それを定義する方法を知ることができます。