GUI ツール

データベースの同期

データベースを同期する機能は、データベースまたはその一部のテーブルを 1 つの接続から別の接続にコピーします。また、データベースをフォルダ内のダンプファイルに保存したり、ダンプファイルから復元することもできます。これは Backup & Restore に置き換えられ、現在「Backup database (Legacy)」と「Restore database (Legacy)」として利用可能です。

TablePlus は独自のダンプとリストアツールを同梱しているため、別途インストールする必要はありません。SSH 経由で接続する際、SSH ホストに pg_dump と pg_restore(または mysqldump と mysql、mariadb-dump と mariadb)が存在する場合はそれらを実行し、存在しない場合は組み込みツールを使用します。

同期データベースを開く

以下のいずれかを行ってください。

  • ウェルカム画面で、左下にあるSync databaseをクリックし、Sync databaseを選択してください。
  • Tools > Sync database... に移動してください。
  • 作業スペースで、Open Anything (⌘ + P) を開き、Sync Database を選択してください。

データベースを同期する

  1. From をクリックし、Choose a Connection or Folder, Files... を選択してソースの接続を指定してください。
  2. コピーする項目を選択してください。
    • データベースにチェックを入れると、テーブル、ビュー、関数、型、スキーマをすべてコピーします。
    • 一部のテーブルだけをコピーするには、データベースを展開し、必要なテーブルにチェックを入れます。パーティションと子テーブルは親テーブルと一緒にコピーされます。
  3. 宛先 で目的の接続を選択し、コピー先のデータベースを選んでください。各データベースは Exists または Create と表示されます。新しいデータベースにコピーするには、リストの最下部にある New database をクリックしてください。
  4. Sync Now をクリックします。
acme_production の3つのテーブルを、acme_staging へのコピーとして、同期データベースのウィンドウを実行
データベースの同期

ソースデータベースを 1 つ選択し、ターゲットデータベースを選択すると、各テーブルがどのように処理されるかが表示されます:Replace、Create、または Kept。Sync は行をマージしません:ターゲットに存在するテーブルは、ソーステーブルによって置換されます。

複数のデータベースを選択すると、それぞれが同じ名前のターゲットデータベースにコピーされます。一部のデータベースが既に存在する場合は、TablePlus は 重複をスキップする、上書きする、または両方を保持する(コピーの名前は、例えば shop_2)のいずれかを選択するかを提示します。

MySQL または MariaDB のターゲットの場合、Back up the target first(デフォルトでオン)にすると、同期前にターゲットデータベースのバックアップが保存されます。復元が失敗した場合、TablePlus はそのバックアップを復元しようとします。

計画を見直してください

TablePlus は、データを書き込む前に両方の側面を確認し、シート上に計画を表示します。「acme_production を acme_staging に同期する?」という形式で、各ステップの実行場所、警告、ターゲットが失う内容、および最初に確認すべき事項をリスト化します。Sync をクリックして開始するか、Cancel をクリックしてください。

もし同期が妨げられる場合、例えば他のテーブルに依存しているテーブルが原因の場合、シートには同期が実行できない理由が表示されます。同期が可能であれば、欠落しているテーブルを選択するための「Add Dependents」ボタンが表示されます。

接続が Safe Mode を使用している場合、TablePlus はまず確認を求めたり、パスワードの入力を求めたりします。

進捗状況を確認します

ログシートには、(準備、ダンプ、転送、復元/保存、完了) の各段階と転送の進捗状況が表示されます。同期を停止するには、Cancel をクリックしてください。エラーが発生すると同期も停止します。同期中に同期ウィンドウを閉じると、TablePlus がStop Sync またはContinue のどちらかを選択するかを尋ねます。

別のアプリに切り替えた場合、同期が完了すると TablePlus から通知が送信されます。

ダンプオプション

Options... の横にあるチェックマークが付けられたソースデータベースをクリックして、ダンプ方法を切り替えてください。

  • PostgreSQL: 圧縮、ファイルとして保存するダンプでデフォルトで有効になっています。
  • MySQL と MariaDB:ロック(デフォルトでは整合的なスナップショットによるロックなしか、テーブルをロック)、ルーチンとトリガー(デフォルトで有効)、イベント、およびバイナリ列を 16 進数形式で。

ダンプツールのフラグを追加するには、Choose...メニューから選択してください。一般的なフラグは最初にリストされ、残りのものはOther Flagsの項目に記載されています。See all flagsはpg_dump、mysqldump、またはmariadb-dumpのドキュメントを開きます。選択したフラグはメニューの下にリストされており、✕をクリックすると 1 つのフラグを削除できます。

メニューにないフラグを入力するには、Add flag manually... を選択し、例えば PostgreSQL には --exclude-table=logs、MySQL には --ignore-table=shop.logs を入力します。各フラグの入力後に Return を押してください。フラグの後にスペースを挟んで値を指定することで、そのフラグを特定できます。TablePlus は、ホスト、ポート、ユーザー、出力ファイル、形式といった自身で設定するフラグは拒否します。同期対象となる 2 つのサーバー間では、ダンプファイル専用となるフラグは除外され、プランには警告が表示されます。

PostgreSQLデータベースのバックアップオプションを、メニューから選択したフラグと、入力された文字列の両方で指定する。
選択肢の洗い出し

Apply to で All databases または This database を選択してください。TablePlus はこの Mac で選択したオプションを記憶します。

フォルダと同期する (または、フォルダから同期する)

From または To リストで、接続の代わりに Choose Folder, Files... を選択してください。

  • フォルダへ:TablePlus は、選択したデータベースをダンプファイルとして保存します:<database>.dump(PostgreSQL カスタム形式)または <database>.sql(MySQL および MariaDB)。ファイル名を変更するには、ファイル横の Rename をクリックし、パターン… で日付などの要素からファイル名を生成します。TablePlus はファイルを上書きしません。ファイル名が既に存在する場合は、_2 を追加します。
  • フォルダから: 復元のためにダンプファイルを選択してください。同期機能は PostgreSQL のカスタム形式と tar アーカイブ、MySQL .sql および .sql.gz ファイルを読み込みます。シンプルな PostgreSQL .sql ファイルを実行するには、File > Import > From SQL Dump... を使用してください。詳細は Import and export を参照してください。

両方の場所からフォルダを選択することはできません。

対応データベース

Sync Database は、PostgreSQL、MySQL および MariaDB の接続に対応しています。

  • 両側で同じデータベースを使用する必要があります。例えば、MySQL から MariaDB へのデータのコピーはできません。
  • 古いバージョンのサーバーにはコピーできません。
  • PostgreSQL の場合、ソースはバージョン 9.2 以降、ターゲットは 9.6 以降である必要があります。

自動同期を実行するには、同期ウィンドウで Schedule... をクリックしてください。詳細については、タスクのスケジュール を参照してください。