Dataphin:Lark Base データソースの作成

前提条件

• カスタム Lark アプリケーションを作成し、その権限付与情報を取得します。詳細については、「アプリケーション権限付与情報の取得」をご参照ください。

• Dataphin に接続する Lark Base の共有リンクを取得します。詳細については、「Base リンクの取得」をご参照ください。

制限事項

• Lark Base テーブルはさまざまなフィールドタイプをサポートしています。Lark Base フィールドと Dataphin フィールドタイプのマッピングについては、「Lark Base 解析ルール」をご参照ください。

• Lark の制限により、Lark 無料版 (Free Edition) の API 呼び出し累計回数は、2024 年 10 月 31 日以降、月間 10,000 回に制限されます。この制限がニーズを満たさない場合は、別の Lark エディションにスペックアップして呼び出しクォータを増やしてください。詳細については、Lark の「カスタムアプリ API 呼び出し制限調整に関する説明」をご参照ください。

権限

スーパー管理者、データソース管理者、ドメインアーキテクト、プロジェクト管理者、および データソース作成権限 を持つカスタムグローバルロールのみがデータソースを作成できます。

操作手順

1. Dataphin ホームページの上部メニューバーで、管理センター > データソース管理 を選択します。

2. データソース ページで、+データソースの作成 をクリックします。

3. データソースの作成 ページで、Lark Base を選択します。

   最近 Lark Base を使用したことがある場合は、最近使用したもの エリアから選択することもできます。また、検索ボックスに Lark Base のキーワードを入力して、迅速に見つけることも可能です。

4. Lark Base データソースの作成 ページで、データソース接続パラメーターを構成します。

   1. データソースの基本情報を構成します。

      パラメーター	説明
      データソース名	データソース名を入力します。以下の命名規則に従ってください。 使用できる文字は、漢字、英大文字・小文字、数字、アンダースコア (_)、ハイフン (-) のみです。 長さは 64 文字以内です。
      データソースコード	データソースコードを構成すると、Flink SQL タスクまたは Dataphin JDBC クライアントで Dataphin データソーステーブルに直接アクセスできるようになります。クイック消費には、data_source_code.table_name または data_source_code.schema.table_name の形式を使用します。タスク実行環境に基づいてデータソースを自動切り替えたい場合は、変数形式 ${data_source_code}.table または ${data_source_code}.schema.table を使用してアクセスします。詳細については、「Dataphin データソーステーブル開発方法」をご参照ください。 重要 データソースコードは、一度構成すると変更できません。 アセットディレクトリおよびアセットチェックリストのオブジェクト詳細ページでデータのプレビューを行うには、データソースコードを構成する必要があります。 Flink SQL では、現在 MySQL、Hologres、MaxCompute、Oracle、StarRocks、Hive、SelectDB、および GaussDB データウェアハウスサービス (DWS) のデータソースのみがサポートされています。
      データソースの説明	Lark Base データソースの簡単な説明を記述します。128 文字以内で記述してください。
      データソース構成	ビジネスデータソースが本番環境と開発環境のデータソースを区別するかどうかに基づいて選択します。 ビジネスデータソースが本番環境と開発環境のデータソースを区別する場合、本番 + 開発データソース を選択します。 ビジネスデータソースが本番環境と開発環境のデータソースを区別しない場合、本番データソース を選択します。
      タグ	タグを使用してデータソースを分類できます。タグの作成方法については、「データソースタグの管理」をご参照ください。

   2. Dataphin とデータソース間の接続パラメーターを構成します。

      データソース構成で 本番 + 開発データソース を選択した場合、両方の環境の接続情報を構成します。本番データソース を選択した場合、本番環境の接続情報のみを構成します。

      説明

      開発と本番を分離し、開発作業が本番データに与える影響を軽減するため、通常は本番データソースと開発データソースを別々に設定する必要があります。ただし、Dataphin では同一のデータソースとして構成することも可能であり、その場合、パラメーター値は共通となります。

      パラメーター	説明
      Lark Base URL	Lark Base のアドレス（例：https://base.feishu.cn/base/appxxxx）を入力します。詳細な手順については、「Base リンクの取得」をご参照ください。
      APP ID、APP Secret	Enterprise Edition 内部アプリケーションの一意のキーとシークレットを入力します。詳細な手順については、「アプリケーション権限付与情報の取得」をご参照ください。

5. デフォルトリソースグループ を選択します。このリソースグループは、現在のデータソースに関連するタスク（データベース SQL 実行、オフライン全データベース移行、データプレビューなど）を実行します。

6. 接続テスト を実行するか、OK をクリックして Lark Base データソースの作成を保存・完了します。

   接続テスト をクリックすると、データソースが Dataphin に接続可能かどうかを確認できます。OK を直接クリックした場合、システムは選択されたすべてのクラスターに対して自動的に接続性をテストします。すべての選択されたクラスターのテストが失敗しても、データソースは作成されます。

   接続テスト は、デフォルトクラスター、または Dataphin に登録済みで正常稼働中の 登録済みスケジューリングクラスター に対して実行されます。デフォルトクラスター はデフォルトで選択され、選択解除はできません。登録済みスケジューリングクラスター にリソースグループが存在しない場合、接続テストはサポートされません。接続テストを実行する前に、まずリソースグループを作成する必要があります。

   • 選択されたクラスターは、現在のデータソースとのネットワーク接続性のテストにのみ使用され、後続の関連タスクの実行には使用されません。

   • 接続テストは通常 2 分以内で完了します。タイムアウトした場合は、 アイコンをクリックして具体的な原因を確認し、再試行してください。

   • テスト結果が 接続失敗、接続成功、または 警告ありで成功 のいずれであっても、システムは最終結果の生成時刻を記録します。

     説明

     デフォルトクラスター のテスト結果には、警告ありで成功、接続成功、接続失敗 の 3 つの接続ステータスが含まれます。一方、Dataphin の 登録済みスケジューリングクラスター のテスト結果には、接続成功 と 接続失敗 の 2 つの接続ステータスしか含まれません。

   • テスト結果が 接続失敗 の場合、 アイコンをクリックして具体的な失敗理由を確認できます。

   • テスト結果が 警告ありで成功 の場合、アプリケーションクラスターへの接続は成功していますが、スケジューリングクラスターへの接続が失敗しています。この場合、現在のデータソースはデータ開発および統合に使用できません。 アイコンをクリックしてログ情報を確認できます。

付録