メインコンテンツへスキップ
メインコンテンツへスキップ

汎用 MariaDB ソース設定ガイド

参考文献

サイドバーに表示されているサポート対象プロバイダーのいずれかを利用している場合は、そのプロバイダー向けの個別ガイドを参照してください。

バイナリログの保持を有効にする​

バイナリログには、MariaDB サーバーインスタンスで行われたデータ変更に関する情報が含まれており、レプリケーションに必要です。

MariaDB インスタンスでバイナリログを有効にするには、次の設定が行われていることを確認してください。

server_id = 1               -- 1以上を指定（0以外の値）
log_bin = ON
binlog_format = ROW
binlog_row_image = FULL
binlog_row_metadata = FULL  -- 10.5.0で導入
expire_logs_days = 1        -- 1以上を指定（0の場合、ログは永久に保持される）

これらの設定を確認するには、以下の SQL コマンドを実行します。

SHOW VARIABLES LIKE 'server_id';
SHOW VARIABLES LIKE 'log_bin';
SHOW VARIABLES LIKE 'binlog_format';
SHOW VARIABLES LIKE 'binlog_row_image';
SHOW VARIABLES LIKE 'binlog_row_metadata';
SHOW VARIABLES LIKE 'expire_logs_days';

値が一致しない場合は、設定ファイル（通常は /etc/my.cnf または /etc/my.cnf.d/mariadb-server.cnf）で設定できます。

[mysqld]
server_id = 1
log_bin = ON
binlog_format = ROW
binlog_row_image = FULL
binlog_row_metadata = FULL  ; 10.5.0以降でのみ利用可能
expire_logs_days = 1

ソースデータベースがレプリカの場合は、log_slave_updates も有効に設定していることを確認してください。

変更を反映させるには、MariaDB インスタンスを必ず再起動する必要があります。

注記

binlog_row_metadata 設定がまだ導入されていないため、MariaDB <= 10.4 ではカラム除外はサポートされていません。

データベースユーザーを構成する​

root ユーザーとして MariaDB インスタンスに接続し、以下のコマンドを実行します。

  1. ClickPipes 専用のユーザーを作成します：

    CREATE USER 'clickpipes_user'@'%' IDENTIFIED BY 'some_secure_password';

  2. スキーマ権限を付与します。次の例では、clickpipes データベースに対する権限を示しています。レプリケーションしたい各データベースおよびホストに対して、これらのコマンドを繰り返してください。

    GRANT SELECT ON `clickpipes`.* TO 'clickpipes_user'@'%';

  3. ユーザーにレプリケーション権限を付与します：

    GRANT REPLICATION CLIENT ON *.* TO 'clickpipes_user'@'%';
GRANT REPLICATION SLAVE ON *.* TO 'clickpipes_user'@'%';
注記

clickpipes_user および some_secure_password は、任意のユーザー名とパスワードに置き換えてください。

SSL/TLS の設定（推奨）​

SSL 証明書により、MariaDB データベースへの安全な接続が確立されます。設定内容は証明書の種類によって異なります。

信頼できる認証局（DigiCert、Let's Encrypt など） - 追加の設定は不要です。

社内認証局 - IT チームからルート CA 証明書ファイルを取得してください。ClickPipes UI で新しい MariaDB ClickPipe を作成する際に、その証明書をアップロードします。

自己ホスト型 MariaDB - MariaDB サーバーから CA 証明書をコピーします（my.cnf 内の ssl_ca 設定でパスを確認してください）。ClickPipes UI で新しい MariaDB ClickPipe を作成する際に、その証明書をアップロードします。ホスト名にはサーバーの IP アドレスを使用してください。

MariaDB 11.4 以降の自己ホスト型 MariaDB - サーバーで ssl_ca が設定されている場合は、上記と同様の手順に従ってください。設定されていない場合は、適切な証明書を用意するよう IT チームに相談してください。最後の手段として、ClickPipes UI の「Skip Certificate Verification」トグルを使用できますが、セキュリティ上の理由から推奨されません。

SSL/TLS オプションの詳細については、FAQ を参照してください。

次のステップ​

これでClickPipe を作成し、MariaDB インスタンスから ClickHouse Cloud へデータの取り込みを開始できます。 MariaDB インスタンスのセットアップ時に使用した接続情報は、ClickPipe の作成時にも必要になるため、必ず記録しておいてください。