TiDB データベース プラットフォームのクイック スタート ガイド

このガイドは、TiDB を始めるための最も簡単な方法を提供します。非実稼働環境の場合は、次のいずれかの方法を使用して TiDB データベースをデプロイできます。

• ローカルテストクラスターをデプロイ (macOS および Linux の場合)
• 単一マシン上で本番デプロイメントをシミュレートする (Linux のみ)

さらに、TiDB の機能をTiDB プレイグラウンドで試すことができます。

注記：

このガイドで提供されるデプロイメント方法は、クイック スタートのみを目的としており、本番向けではありません。

• セルフホスト型本番クラスタを展開するには、 本番インストールガイドを参照してください。
• TiDB を Kubernetes にデプロイするには、 Kubernetes で TiDB を使ってみるを参照してください。
• クラウドで TiDB を管理するには、 TiDB Cloudクイック スタートを参照してください。

ローカルテストクラスターをデプロイ

• シナリオ: 単一の macOS または Linuxサーバーを使用して、テスト用にローカル TiDB クラスターを迅速にデプロイします。このようなクラスターをデプロイすることで、TiDB の基本的なアーキテクチャと、TiDB、TiKV、PD、モニタリング コンポーネントなどのそのコンポーネントの操作を学ぶことができます。

• macOS
• Linux

単一マシン上で本番デプロイメントをシミュレートする

• シナリオ: 完全なトポロジーを備えた最小の TiDB クラスターを体験し、単一の Linuxサーバー上での本番デプロイメント・ステップをシミュレートします。

このセクションでは、 TiUPで最小のトポロジの YAML ファイルを使用して TiDB クラスターをデプロイする方法について説明します。

準備する

TiDB クラスターをデプロイする前に、ターゲット マシンが次の要件を満たしていることを確認してください。

• CentOS 7.3以降がインストールされていること。
• Linux OS はインターネットにアクセスできます。これは、TiDB および関連ソフトウェア インストール パッケージをダウンロードするために必要です。

最小の TiDB クラスター トポロジは、次のインスタンスで構成されます。

注記：

インスタンスの IP アドレスは例としてのみ示されています。実際の展開では、IP アドレスを実際の IP アドレスに置き換えます。

ターゲット マシンのその他の要件は次のとおりです。

• rootユーザーとそのパスワードが必要です

• ターゲットマシンのファイアウォールサービスを停止します 、または TiDB クラスターノードに必要なポートを開きます

• 現在、 TiUPクラスターは、x86_64 (AMD64) および ARM アーキテクチャでの TiDB のデプロイをサポートしています。

  • AMD64 では CentOS 7.3 以降のバージョンを使用することをお勧めします。
  • ARM では CentOS 7.6 1810 を使用することをお勧めします。

デプロイ

注記：

対象マシンには通常ユーザーまたはrootユーザーとしてログインできます。次の手順では、例としてrootユーザーを使用します。

1. TiUPをダウンロードしてインストールします。

   curl --proto '=https' --tlsv1.2 -sSf https://tiup-mirrors.pingcap.com/install.sh | sh
   

2. グローバル環境変数を宣言します。

   注記：

   インストール後、 TiUP は対応するシェル プロファイル ファイルの絶対パスを表示します。以下のsourceコマンドの${your_shell_profile}パスに合わせて変更する必要があります。

   source ${your_shell_profile}
   

3. TiUPのクラスターコンポーネントをインストールします。

   tiup cluster
   

4. TiUPクラスターが既にマシンにインストールされている場合は、ソフトウェア バージョンを更新します。

   tiup update --self && tiup update cluster
   

5. root ユーザー権限を使用して、 sshdサービスの接続制限を増やします。これは、 TiUP が複数のマシンでの展開をシミュレートする必要があるためです。

   1. /etc/ssh/sshd_configを変更し、 MaxSessions ～ 20を設定します。

   2. sshdサービスを再起動します。

      service sshd restart
      

6. クラスターを作成して起動します。

   次のテンプレートに従って構成ファイルを編集し、 topo.yamlという名前を付けます。

   # # Global variables are applied to all deployments and used as the default value of
   # # the deployments if a specific deployment value is missing.
   global:
    user: "tidb"
    ssh_port: 22
    deploy_dir: "/tidb-deploy"
    data_dir: "/tidb-data"
   
   # # Monitored variables are applied to all the machines.
   monitored:
    node_exporter_port: 9100
    blackbox_exporter_port: 9115
   
   server_configs:
    tidb:
      instance.tidb_slow_log_threshold: 300
    tikv:
      readpool.storage.use-unified-pool: false
      readpool.coprocessor.use-unified-pool: true
    pd:
      replication.enable-placement-rules: true
      replication.location-labels: ["host"]
    tiflash:
      logger.level: "info"
   
   pd_servers:
    - host: 10.0.1.1
   
   tidb_servers:
    - host: 10.0.1.1
   
   tikv_servers:
    - host: 10.0.1.1
      port: 20160
      status_port: 20180
      config:
        server.labels: { host: "logic-host-1" }
   
    - host: 10.0.1.1
      port: 20161
      status_port: 20181
      config:
        server.labels: { host: "logic-host-2" }
   
    - host: 10.0.1.1
      port: 20162
      status_port: 20182
      config:
        server.labels: { host: "logic-host-3" }
   
   tiflash_servers:
    - host: 10.0.1.1
   
   monitoring_servers:
    - host: 10.0.1.1
   
   grafana_servers:
    - host: 10.0.1.1
   

   • user: "tidb" : tidbシステム ユーザー (展開中に自動的に作成される) を使用して、クラスターの内部管理を実行します。デフォルトでは、ポート 22 を使用して SSH 経由でターゲット マシンにログインします。
   • replication.enable-placement-rules : この PD パラメータは、 TiFlash が正常に動作することを保証するために設定されます。
   • host : ターゲットマシンのIP。

7. クラスター展開コマンドを実行します。

   tiup cluster deploy <cluster-name> <version> ./topo.yaml --user root -p
   

   • <cluster-name> : クラスター名を設定します

   • <version> : TiDB クラスターのバージョンを設定します ( v7.1.2など)。 tiup list tidbコマンドを実行すると、サポートされているすべての TiDB バージョンを確認できます。

   • -p : ターゲットマシンへの接続に使用するパスワードを指定します。

     注記：

     秘密キーを使用する場合は、 -iまでのキーのパスを指定できます。 -iと-pを同時に使用しないでください。

   「y」とrootユーザーのパスワードを入力して、展開を完了します。

   Do you want to continue? [y/N]:  y
   Input SSH password:
   

8. クラスターを開始します。

   tiup cluster start <cluster-name>
   

9. クラスターにアクセスします。

   • MySQL クライアントをインストールします。すでにインストールされている場合は、この手順をスキップしてください。

     yum -y install mysql
     

   • TiDB にアクセスします。パスワードが空です:

     mysql -h 10.0.1.1 -P 4000 -u root
     

   • http://{グラファナ-ip}:3000から Grafana 監視ダッシュボードにアクセスします。デフォルトのユーザー名とパスワードは両方ともadminです。

   • http://{pd-ip}:2379/ダッシュボードでTiDB ダッシュボードにアクセスします。デフォルトのユーザー名はrootで、パスワードは空です。

   • 現在デプロイされているクラスターのリストを表示するには、次の手順を実行します。

     tiup cluster list
     

   • クラスターのトポロジーとステータスを表示するには、次の手順を実行します。

     tiup cluster display <cluster-name>
     

次は何ですか

ローカル テスト環境に TiDB クラスターをデプロイしたばかりの場合は、次の手順を実行します。

• TiDB の基本的な SQL 操作については、 TiDB の基本的な SQL 操作を参照してください。
• データを TiDB に移行するを参照してデータを TiDB に移行することもできます。

TiDB クラスターを本番環境にデプロイする準備ができている場合は、次の手順を実行します。

• TiUPを使用して TiDBをデプロイ
• または、ドキュメントKubernetes 上の TiDBを参照して、 TiDB Operatorを使用して TiDB をクラウドにデプロイすることもできます。

TiFlashを使用した分析ソリューションをお探しの場合は、次の手順を実行してください。

• TiFlashを使用する
• TiFlashの概要