DataWorks を使用して ApsaraDB for ClickHouse クラスターのタスクを開発および管理するには、クラスターを DataWorks の ClickHouse 計算リソースとして追加する必要があります。これにより、DataWorks から ApsaraDB for ClickHouse クラスターに接続し、データ同期やデータ開発などの操作を実行できます。
前提条件
ApsaraDB for ClickHouse クラスターが作成されていること。
説明ClickHouse クラスターは、ClickHouse 計算リソースがアタッチされている DataWorks ワークスペースと同じ [リージョン] に作成することをお勧めします。
クラスターとワークスペースが異なるリージョンにある場合、クラスターはクロスリージョンデータソースとしてのみ追加できます。このタイプのデータソースは、データ同期タスクにのみ使用でき、データ開発またはオペレーションセンターの計算タスクには使用できません。
DataWorks で ワークスペースが作成されていること。操作を実行する RAM ユーザーがワークスペースに追加され、ワークスペース管理者ロールが割り当てられていること。
リソースグループがワークスペースにアタッチされており、ネットワーク接続が確認されていること。
Serverless リソースグループを使用する場合、Serverless リソースグループ が ApsaraDB for ClickHouse クラスターに接続できることを確認してください。
従来の専用リソースグループを使用する場合、シナリオに応じて、統合用の専用リソースグループ、専用スケジューリングリソースグループ、および サービス用の専用リソースグループ が ApsaraDB for ClickHouse クラスターに接続できることを確認してください。
デフォルトでは、ApsaraDB for ClickHouse クラスターはすべての IP アドレスからのアクセスを拒否します。計算リソースをアタッチする前に、リソースグループの vSwitch CIDR ブロック、従来のリソースグループの EIP、または Serverless リソースグループにアタッチされた VPC の EIP を ApsaraDB for ClickHouse クラスターのホワイトリストに追加する必要があります。そうしないと、接続が失敗し、ClickHouse 計算リソースをアタッチできません。
説明vSwitch CIDR ブロック、従来のリソースグループの EIP、または Serverless リソースグループにアタッチされた VPC の EIP の取得方法の詳細については、「DataWorks ホワイトリストへの IP アドレスの追加」をご参照ください。
制限事項
機能制限: ClickHouse コンピュートエンジンで SSL 認証サービスが有効になっている場合、データ開発または定期的なスケジューリングタスクには使用できません。
リージョン制限: 中国 (杭州)、中国 (上海)、中国 (北京)、中国 (深圳)、中国 (成都)、中国 (香港)、日本 (東京)、シンガポール、マレーシア (クアラルンプール)、インドネシア (ジャカルタ)。
権限の制限:
オペレーター
必要な権限
Alibaba Cloud アカウント
追加の権限は必要ありません。
RAM ユーザー/RAM ロール
O&M または Workspace Administrator ロールを持つワークスペースメンバー、または
AliyunDataWorksFullAccess権限を持つメンバーのみが計算リソースを作成できます。権限付与の詳細については、「ユーザーへのワークスペース管理者権限の付与」をご参照ください。
新しい DataStudio で ClickHouse 計算リソースをアタッチする
[Data Studio (新バージョン) を使用] が有効なワークスペースに ClickHouse 計算リソースをアタッチします。
計算リソースページに移動
DataWorks コンソールにログインします。上部のナビゲーションバーで、ターゲットリージョンを選択します。左側のナビゲーションウィンドウで、 を選択します。ドロップダウンリストから目的のワークスペースを選択し、[管理センターへ] をクリックします。
左側のナビゲーションウィンドウで [計算リソース] をクリックして、計算リソースページに移動します。
ClickHouse 計算リソースのアタッチ
[計算リソース] ページで、ClickHouse 計算リソースを構成してアタッチします。
計算リソースタイプを選択します。
[計算リソースのアタッチ] をクリックして、[計算リソースのアタッチ] ページに移動します。
[計算リソースのアタッチ] ページで、計算リソースタイプを [ClickHouse] に設定すると、[ClickHouse 計算リソースのアタッチ] 構成ページが開きます。
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 クラスターにアクセスするための認証方式を選択します。
認証なし: 他の操作は必要ありません。
SSL 認証: このメソッドを選択した場合は、後で検証するために、ApsaraDB for ClickHouse クラスターの [クラスター情報] ページから [CA 証明書のダウンロード] を行う必要があります。
説明ClickHouse コンピュートエンジンで SSL 認証サービスが有効になっている場合、データ開発または定期的なスケジューリングタスクには使用できません。
SSL CA 証明書
[認証オプション] を [SSL 認証] に設定した場合は、下の [認証ファイルの追加] をクリックし、ApsaraDB for ClickHouse クラスターの [クラスター情報] ページからダウンロードした CA 証明書をアップロードします。
計算リソースインスタンス名
計算リソースインスタンスのカスタム名を入力します。
接続性をテストします。
接続構成セクションで、ClickHouse ノードタスクを実行するためのリソースグループを選択します。[接続性のテスト] をクリックして、リソースグループが ApsaraDB for ClickHouse クラスターに接続できることを確認します。詳細については、「ネットワーク接続ソリューションの概要」をご参照ください。
[確認] をクリックして構成を完了します。
従来のデータ開発で ClickHouse 計算リソースをアタッチする
[Data Studio (新バージョン) を使用] が有効になっていないワークスペースに ClickHouse 計算リソースをアタッチします。
計算リソースページに移動
DataStudio ページに移動します。
DataWorks コンソールにログインします。上部のナビゲーションバーで、目的のリージョンを選択します。左側のナビゲーションウィンドウで、 を選択します。表示されたページで、ドロップダウンリストから目的のワークスペースを選択し、[データ開発へ] をクリックします。
左側のナビゲーションウィンドウで、
アイコンをクリックして [計算リソース] ページを開きます。
ClickHouse 計算リソースのアタッチ
計算リソースページで、ClickHouse 計算リソースを構成してアタッチします。
計算リソースタイプを選択します。
[新しい計算リソース] をクリックして、[新しい計算リソース] ページに移動します。
[新しい計算リソース] ページで、計算リソースタイプを [ClickHouse] に設定します。[新しい計算リソース] 構成ページが開きます。
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 クラスターにアクセスするための認証方式を選択します。
認証なし: 他の操作は必要ありません。
SSL 認証: このメソッドを選択した場合は、後で検証するために、ApsaraDB for ClickHouse クラスターの [クラスター情報] ページから [CA 証明書のダウンロード] を行う必要があります。
説明ClickHouse コンピュートエンジンで SSL 認証サービスが有効になっている場合、データ開発または定期的なスケジューリングタスクには使用できません。
SSL CA 証明書
[認証オプション] を [SSL 認証] に設定した場合は、下の [認証ファイルの追加] をクリックし、ApsaraDB for ClickHouse クラスターの [クラスター情報] ページからダウンロードした CA 証明書をアップロードします。
接続性をテストします。
接続構成セクションで、ClickHouse タスクを実行するためのリソースグループを選択します。[接続性のテスト] をクリックして、リソースグループが ApsaraDB for ClickHouse クラスターに接続できることを確認します。詳細については、「ネットワーク接続ソリューションの概要」をご参照ください。
[計算リソースを作成してデータ開発にアタッチ] をクリックして構成を完了します。
次のステップ
新しい 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 アドレスが正しいことを確認してください。