すべてのプロダクト
Search
ドキュメントセンター

DataWorks:ClickHouse 計算リソースのアタッチ

最終更新日:Nov 14, 2025

DataWorks を使用して ApsaraDB for ClickHouse クラスターのタスクを開発および管理するには、クラスターを DataWorks の ClickHouse 計算リソースとして追加する必要があります。これにより、DataWorks から ApsaraDB for ClickHouse クラスターに接続し、データ同期やデータ開発などの操作を実行できます。

前提条件

制限事項

  • 機能制限: ClickHouse コンピュートエンジンで SSL 認証サービスが有効になっている場合、データ開発または定期的なスケジューリングタスクには使用できません。

  • リージョン制限: 中国 (杭州)、中国 (上海)、中国 (北京)、中国 (深圳)、中国 (成都)、中国 (香港)、日本 (東京)、シンガポール、マレーシア (クアラルンプール)、インドネシア (ジャカルタ)。

  • 権限の制限:

    オペレーター

    必要な権限

    Alibaba Cloud アカウント

    追加の権限は必要ありません。

    RAM ユーザー/RAM ロール

    O&M または Workspace Administrator ロールを持つワークスペースメンバー、または AliyunDataWorksFullAccess 権限を持つメンバーのみが計算リソースを作成できます。権限付与の詳細については、「ユーザーへのワークスペース管理者権限の付与」をご参照ください。

新しい DataStudio で ClickHouse 計算リソースをアタッチする

[Data Studio (新バージョン) を使用] が有効なワークスペースに ClickHouse 計算リソースをアタッチします。

計算リソースページに移動

  1. DataWorks コンソールにログインします。上部のナビゲーションバーで、ターゲットリージョンを選択します。左側のナビゲーションウィンドウで、[その他] > [管理センター] を選択します。ドロップダウンリストから目的のワークスペースを選択し、[管理センターへ] をクリックします。

  2. 左側のナビゲーションウィンドウで [計算リソース] をクリックして、計算リソースページに移動します。

ClickHouse 計算リソースのアタッチ

[計算リソース] ページで、ClickHouse 計算リソースを構成してアタッチします。

  1. 計算リソースタイプを選択します。

    1. [計算リソースのアタッチ] をクリックして、[計算リソースのアタッチ] ページに移動します。

    2. [計算リソースのアタッチ] ページで、計算リソースタイプを [ClickHouse] に設定すると、[ClickHouse 計算リソースのアタッチ] 構成ページが開きます。

  2. ClickHouse 計算リソースを構成します。

    [ClickHouse 計算リソースのアタッチ] 構成ページで、次の表の説明に従ってパラメーターを設定します。

    パラメーター

    説明

    構成モード

    接続文字列モードのみがサポートされています。

    JDBC URL

    JDBC URL フォーマット: jdbc:clickhouse://<ip>:<port>/<dbname>

    • <ip>: ClickHouse の [クラスター情報] ページの [VPC アドレス] または [パブリックアドレス]。例: cc-bp1xxx..clickhouse.ads.aliyuncs.com

    • <port>: [認証オプション][認証なし] の場合は、ClickHouse の [クラスター情報] ページにある [VPC HTTP ポート番号] (8123) を使用します。[認証オプション][SSL 認証] の場合は、ClickHouse の [クラスター情報] ページにある [VPC HTTPS ポート番号] (8443) を使用します。

    • <dbname>: 使用する ClickHouse データベース。デフォルト値は default です。必要に応じて新しいデータベースを作成できます。

    ユーザー名とパスワード

    ApsaraDB for ClickHouse クラスターのアカウントとパスワード

    認証オプション

    ApsaraDB for ClickHouse クラスターにアクセスするための認証方式を選択します。

    • 認証なし: 他の操作は必要ありません。

    • SSL 認証: このメソッドを選択した場合は、後で検証するために、ApsaraDB for ClickHouse クラスターの [クラスター情報] ページから [CA 証明書のダウンロード] を行う必要があります。

      説明

      ClickHouse コンピュートエンジンで SSL 認証サービスが有効になっている場合、データ開発または定期的なスケジューリングタスクには使用できません。

    SSL CA 証明書

    [認証オプション] を [SSL 認証] に設定した場合は、下の [認証ファイルの追加] をクリックし、ApsaraDB for ClickHouse クラスターの [クラスター情報] ページからダウンロードした CA 証明書をアップロードします。

    計算リソースインスタンス名

    計算リソースインスタンスのカスタム名を入力します。

  3. 接続性をテストします。

    接続構成セクションで、ClickHouse ノードタスクを実行するためのリソースグループを選択します。[接続性のテスト] をクリックして、リソースグループが ApsaraDB for ClickHouse クラスターに接続できることを確認します。詳細については、「ネットワーク接続ソリューションの概要」をご参照ください。

  4. [確認] をクリックして構成を完了します。

従来のデータ開発で ClickHouse 計算リソースをアタッチする

[Data Studio (新バージョン) を使用] が有効になっていないワークスペースに ClickHouse 計算リソースをアタッチします。

計算リソースページに移動

  1. DataStudio ページに移動します。

    DataWorks コンソールにログインします。上部のナビゲーションバーで、目的のリージョンを選択します。左側のナビゲーションウィンドウで、[データ開発と O&M] > [データ開発] を選択します。表示されたページで、ドロップダウンリストから目的のワークスペースを選択し、[データ開発へ] をクリックします。

  2. 左側のナビゲーションウィンドウで、image アイコンをクリックして [計算リソース] ページを開きます。

ClickHouse 計算リソースのアタッチ

計算リソースページで、ClickHouse 計算リソースを構成してアタッチします。

  1. 計算リソースタイプを選択します。

    1. [新しい計算リソース] をクリックして、[新しい計算リソース] ページに移動します。

    2. [新しい計算リソース] ページで、計算リソースタイプを [ClickHouse] に設定します。[新しい計算リソース] 構成ページが開きます。

  2. ClickHouse 計算リソースを構成します。

    [新しい計算リソース] 構成ページで、次の表の説明に従ってパラメーターを設定します。

    パラメーター

    説明

    データソース名

    計算リソースのカスタム名を入力します。

    構成モード

    接続文字列モードのみがサポートされています。

    ホストアドレス/IP

    ApsaraDB for ClickHouse クラスターの [クラスター情報] ページの [VPC アドレス] または [パブリックアドレス]。例: cc-bp1xxx..clickhouse.ads.aliyuncs.com

    ポート

    [認証オプション][認証なし] に設定した場合は、ApsaraDB for ClickHouse クラスターの [クラスター情報] ページにある [VPC HTTP ポート] (8123) を使用します。

    [認証オプション][SSL 認証] に設定した場合は、ApsaraDB for ClickHouse クラスターの [クラスター情報] ページにある [VPC HTTPS ポート] (8443) を使用します。

    データベース名

    使用する ClickHouse データベース。デフォルト値は default です。必要に応じて新しいデータベースを作成することもできます。

    ユーザー名とパスワード

    ApsaraDB for ClickHouse クラスターのアカウントとパスワード

    バージョン

    アタッチするクラスターのバージョンを指定します。

    詳細パラメーター

    このパラメーターはオプションです。[プロパティの追加] をクリックしてプロパティを構成できます。

    認証オプション

    ApsaraDB for ClickHouse クラスターにアクセスするための認証方式を選択します。

    • 認証なし: 他の操作は必要ありません。

    • SSL 認証: このメソッドを選択した場合は、後で検証するために、ApsaraDB for ClickHouse クラスターの [クラスター情報] ページから [CA 証明書のダウンロード] を行う必要があります。

      説明

      ClickHouse コンピュートエンジンで SSL 認証サービスが有効になっている場合、データ開発または定期的なスケジューリングタスクには使用できません。

    SSL CA 証明書

    [認証オプション] を [SSL 認証] に設定した場合は、下の [認証ファイルの追加] をクリックし、ApsaraDB for ClickHouse クラスターの [クラスター情報] ページからダウンロードした CA 証明書をアップロードします。

  3. 接続性をテストします。

    接続構成セクションで、ClickHouse タスクを実行するためのリソースグループを選択します。[接続性のテスト] をクリックして、リソースグループが ApsaraDB for ClickHouse クラスターに接続できることを確認します。詳細については、「ネットワーク接続ソリューションの概要」をご参照ください。

  4. [計算リソースを作成してデータ開発にアタッチ] をクリックして構成を完了します。

次のステップ

  • 新しい DataStudio: ClickHouse 計算リソースをアタッチした後、データ同期には バッチ同期ノード を、データ開発には ClickHouse SQL ノード を使用できます。

  • 従来のデータ開発: ClickHouse 計算リソースをアタッチした後、データ同期には データ統合 > バッチ同期 ノードを使用できます。

よくある質問

  • エラーメッセージ: "not support data sync channel, error code: 0001."

    解決策: JDBC URL パラメーターにスペースや余分な文字が含まれていないことを確認してください。

  • エラーメッセージ: ru.yandex.clickhouse.except.ClickHouseUnknownException: ClickHouse exception, code: 1002.

    解決策: IP アドレスが正しいことを確認してください。