Dataphin:Feishu バイタブルデータソースの作成

前提条件

• Feishu でカスタムエンタープライズアプリケーションを作成し、必要な権限情報を取得していること。詳細については、「アプリケーション権限情報の取得」をご参照ください。

• Dataphin に接続する Feishu バイタブルの共有リンクを取得していること。詳細については、「バイタブルリンクの取得」をご参照ください。

制限事項

• Feishu バイタブルと Dataphin 間のフィールドタイプマッピングについては、「Feishu バイタブルの解析ルール」をご参照ください。

• Feishu の API レート制限により、Feishu Basic Free プランでは、2024 年 10 月 31 日以降、1 か月あたり最大 10,000 回の API 呼び出しが可能です。この制限がニーズに不十分な場合は、Feishu プランをアップグレードして呼び出しクォータを増やすことができます。詳細については、Feishu の「Adjustments to API Call Limits for Custom Applications」をご参照ください。

権限

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

操作手順

1. Dataphin ホームページの上部のナビゲーションバーで、[管理センター] > [データソース管理] を選択します。

2. [データソース] ページで、[+ 新しいデータソース] をクリックします。

3. [新規データソース] ページで、[Feishu Bitable] を選択します。

   最近 Feishu Bitable を使用した場合は、[最近使用した項目] セクションから選択することもできます。または、検索バーにキーワードを入力して見つけることもできます。

4. [新規 Feishu Bitable データソース] ページで、接続パラメーターを設定します。

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

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

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

      [本番 + 開発データソース] を選択した場合は、本番データソースと開発データソースの両方 の接続情報を設定する必要があります。[本番データソース] を選択した場合は、本番データソース の接続情報のみを設定する必要があります。

      説明

      通常、開発作業が本番環境に影響を与えないように、環境を分離して本番データソースと開発データソースを個別に設定する必要があります。ただし、Dataphin では、同一のパラメータ値を使用して、同じデータソースとして設定することもできます。

      パラメータ	説明
      [Feishu バイタブル URL]	Feishu バイタブルの URL (例： https://base.feishu.cn/base/appxxxx)。詳細な手順については、「バイタブルリンクの取得」をご参照ください。
      [アプリ ID] および [App Secret]	カスタムエンタープライズアプリケーションの一意のキーとシークレット。これらの認証情報の取得方法の詳細な手順については、「アプリケーション権限情報の取得」をご参照ください。

5. [デフォルトリソースグループ] を選択します。このリソースグループは、データベースの SQL 実行、オフラインのフルデータベース移行、データプレビューなどのデータソース関連のタスクを実行するために使用されます。

6. [接続テスト] または [OK] をクリックして設定を保存し、Feishu Bitable データソースを作成します。

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

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

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

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

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

     説明

     デフォルトクラスター のテスト結果のみが、警告あり接続成功、接続成功、接続失敗 の 3 種類のステータスを含みます。登録済みスケジューリングクラスター のテスト結果は、接続成功 および 接続失敗 の 2 種類のみです。

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

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

付録