リファレンスドキュメント > データ > Connectivity > Connectivity workflows

Connectivity workflows¶

The DataRobot connectivity platform allows users to integrate with their data stores using either the DataRobot-provided native connectors or uploading the JDBC driver provided by the data store.

技術的な知識と権限を持つユーザーは、データ接続を設定および確立できます。組織内の他のユーザーは、これらの接続を活用してビジネス上の問題を解決できます。

Terminology¶

Data store: A configured connection to a database. It has a name, a specified driver, and a JDBC URL. You can register data stores with DataRobot for ease of re-use. A data store has one connector but can have many data sources.
Data source: A configured connection to the backing data store (the location of data within a given endpoint). A data source specifies, via a SQL query or a selected table and schema data, which data to extract from the data store to use for modeling or predictions. A data source has one data store and one connector but can have many datasets.
Data driver: The software that allows the application to interact with a database; each data store is associated with either a driver or a connector (created by the administrator). The driver configuration saves the storage location in the application of the JAR file and any additional dependency files associated with the driver.
Connector: Similarly to data drivers, a connector allows the application to interact with a database; each data store is associated with either a driver or a connector (created by the administrator). The connector configuration saves the storage location in the application of the JAR file and any additional dependency files associated with the connector.
Dataset: Data, a file or the content of a data source, at a particular point in time. A data source can produce multiple datasets; a dataset has exactly one data source.

Connectivity options¶

By default, users can create, modify (depending on their role), and share data connections as well as create data sources. DataRobotの1つの領域で接続を作成または再設定すると、その更新内容はワークベンチ、レジストリ、およびデータ接続ページ（つまり、データ接続を操作するすべての領域）にも適用されます。

The tabs below describe where you can establish database connectivity in DataRobot:

構造化データ非構造化データ

アカウント設定 > データ接続から、データ接続設定を作成します。
レジストリ > データから、追加 > データ接続をクリックします。
ユースケース内のデータを参照モーダルから。

During vector database (VDB) creation when adding a new data source.

Interface overview¶

While the database connectivity user interface (UI) remains consistent across the platform, there are minor differences based on where you're working with connections. See the example below—which shows editing a connection from Account settings > Data connections—for a general description of the user interface (UI) elements in the database connectivity window:

	要素	説明
1	+ 接続を追加	新しいデータ接続の追加と設定ができます。
2	接続リスト	DataRobotのアカウントに関連付けられているすべてのデータ接続を一覧表示します。
3	接続設定	DataRobotと外部データソース間の接続を確立するために使用されるパラメーターを表示します。
4	データソース	データ接続からインポートされたデータセットのリストを表示します。
5	資格情報	データ接続に関連付けられた認証資格情報のリストを表示します。
6	削除	データ接続を削除します。
7	テスト	認証資格情報を含むデータ接続設定をテストします。
8	共有	データ接続を他のユーザー、グループ、または組織と共有し、権限を割り当てることができます。
9	保存	接続設定に加えられた変更を保存します。
10	追加パラメーターを表示	接続設定にパラメーターを追加できます。

データソースへの接続¶

備考

データ接続を設定する際、設定タイプ、認証オプション、必須パラメーターは、選択したデータソースに基づいています。 The example below shows how to configure Snowflake with OAuth using existing credentials from the Browse data modal within a Use Case.

データ接続を作成するには：

From the database connectivity window, click + Add connection.
構造化データの追加をサポートする接続の場合は構造化、非構造化データをサポートする接続の場合は非構造化を選択します（VDBの作成時のみ利用できます）。続いて、データストアを選択します。

セルフマネージドAIプラットフォームのインストール

セルフマネージドAIプラットフォームでのインストールの場合、リストされているデータストアが表示されていない可能性があります。その場合、新しいドライバーを追加をクリックし、サポートされているデータベース接続のリストからドライバーを追加します。

これで、データ接続を設定できます。

接続の設定¶

データ接続を設定するには：

接続を編集モーダルで接続設定タブを選択し、パラメーターまたはJDBC URLのいずれかの設定方法を選択します。
選択した設定方法に必要なパラメーターを入力します。
新しい資格情報をクリックし、認証方法を選択します。利用可能な認証方法は選択された接続に基づきます。

保存済みの資格情報

以前に選択したデータソースの資格情報を保存している場合は、資格情報を保存をクリックして、ドロップダウンから適切な資格情報を選択します。
右上隅の保存をクリックします。ブラウザーのウィンドウが小さい場合は、上方向にスクロールする必要があります。

If you selected OAuth as your authentication method, you will be prompted to sign in before you can select data. サポートされている認証方法と必要なパラメーターの詳細については、サポートされているデータストアのリストを参照してください。

追加パラメーター¶

データ接続設定画面に表示されるパラメーターは、選択したドライバーに応じて異なります。使用可能なパラメーターはドライバーを追加した管理者が行った設定に応じて異なります。

その他の多くのフィールドは、検索可能な拡張フィールドにあります。必要なフィールドが一覧にない場合、追加パラメーターを表示を開き、パラメーターを追加するをクリックして追加します。

接続設定に表示されるパラメーターを削除するには、削除アイコンをクリックします。

備考

データベースへの接続を設定するために追加のパラメーターが必要な場合があります。これらのパラメーターは、DataRobotで常に事前定義されているわけではありません。その場合、手動で追加する必要があります。

必要なパラメーターの詳細については、データベースのドキュメントを参照してください。

データを選択¶

データソースは、SQLクエリーまたは選択されたテーブルとスキーマデータを介して、データ接続から取得するデータを指定します。このデータはモデリングおよび予測に使用するために抽出されるデータです。データベーステーブル全体をポイントするか、SQLクエリーを使用してデータベースから特定のデータを選択することができます。

To select data:

追加するテーブルに関連付けられたスキーマを選択します。

該当するテーブルの左側にあるボックスを選択します。

データセットを選択すると、以下の操作を行うことができます。

	要素	説明
1	ユースケースに追加	データアセットをユースケースに追加し、自分や他のチームメンバーが使用できるようにします。
2	SQLクエリーから追加	SQLクエリーを使用してデータを追加できます。
3	設定	列の表示、非表示、ピン留めができます。
4	アクションメニュー	以下のアクションにアクセスできます。プレビュー：スナップショットのプレビューを開き、データセットがユースケースに関連しているかどうかや、ラングラーまたはSQLエディターで修正する必要があるかどうかを判断します。ラングラーで開く：ユースケースにアセットを追加する前に、データの準備を行います。 SQLエディターで開く：データセットを強化、変換、整形、およびブレンドするSQLクエリーで構成されたレシピを作成します。

大規模データセット

ユースケースに追加する前にデータセットのサイズを小さくする場合は、ラングリングをクリックします。レシピをパブリッシュするとき、自動ダウンサンプリングを設定して、Snowflakeが出力データセットをマテリアライズするときの行数を制御することができます。

ユースケースに追加をクリックしてから、動的データ（動的データセットとして追加）またはデータセットのスナップショット（スナップショットとして追加）のいずれかを追加して、スナップショットポリシーを選択します。データを追加せずに戻るには、閲覧を続行をクリックします。

Manage connections¶

接続のテスト¶

データ接続が作成されたら、テストをクリックして接続をテストします。

表示されるダイアログボックスで、データ接続作成画面のJDBC URLフィールドまたはパラメーターベースの設定に表示されているデータベースの資格情報を入力するか、保存されている資格情報を使用します。 サインインをクリックし、テストに合格したら、閉じるをクリックしてデータ接続タイルに戻り、データソースを作成します。

SnowflakeおよびGoogle BigQueryのユーザーは、OAuthのシングルサインオンを使用してデータ接続を設定できます。設定した後は、運用データベースからデータを読み取ってモデル構築と予測に使用することができます。

OAuthを使用したデータ接続の設定、必要なパラメーター、およびトラブルシューティングの手順については、データベースのドキュメントを参照してください。Snowflakeまたは BigQuery。

Edit connections¶

関連付けられた資格情報やデータソースだけでなく、設定パラメーターを含む既存のデータ接続を変更することができます。

接続を編集するには、左側のパネルでデータ接続をクリックします。各タブの説明（各タブにどのような情報が表示され、どのような編集オプションを利用できるか）については、以下を参照してください。

接続設定データソース資格情報

接続設定タブでは、新しいパラメーターの追加、新しい資格情報の選択や作成など、接続パラメーターを変更できます。

データソースタブには、この接続を通じてこれまでにアクセスされたすべてのデータアセットが表示されます。このリストを使用すると、データベースで最も頻繁に使用されているテーブルやSQLクエリー、およびBLOB（バイナリーラージオブジェクト）やドキュメントストアでのファイルの場所を確認できます。この接続からデータレジストリまたはユースケースにデータセットやファイルが追加されると、そのデータへのポインターが自動的にこのタブに追加されます。さらに、接続設定でデータソースを直接追加することもできます。なお、このビューはデータガバナンスのワークフローにも対応しています。

ここから、次のことができます。

	要素	説明
1	検索	特定のデータソースを検索できます。
2	列	データポインターが最後に更新されたときの名前と日付が表示されます。
3	アクションメニュー	以下のアクションにアクセスできます。共有：ユーザーとデータソースを共有できます。削除：データ接続とデータソースの関連付けを削除します。このデータソースを使用して作成されたデータセット/ファイルは、データレジストリやユースケースから削除されることはありません。

資格情報タブには、この接続タイプに対応し、ユーザーが追加した、または共有のセキュアな構成を通じて共有されたすべての資格情報が表示されます。ここから、次のことができます。

	要素	説明
1	検索	特定の資格情報を検索できます。
2	列	名前、資格情報のタイプ、および資格情報が最初に追加された日付を表示します。
3	選択されたバッジ	データ接続で現在使用されている資格情報を示します。
4	アクションメニュー	以下のアクションにアクセスできます。選択：データ接続の認証に使用する新しい資格情報を選択します。テスト：資格情報を使用して接続をテストおよび認証します。編集：資格情報を展開して、手動や共有のセキュアな構成を編集できるようにします。資格情報をクリックして、このパネルを展開することもできます。削除：資格情報を削除し、関連付けられたすべてのデータ接続から取り除きます。

接続の編集が終了したら、保存をクリックします。

Delete connections¶

既存のデータソースで使用されていないデータ接続を削除できます。使用されている場合は、依存ファイルを最初に削除する必要があります。データ接続を削除するには：

データ接続タブで、左側の接続リストからデータ接続を選択します。
右上の削除ボタンをクリックするか、左側のパネルにある接続名にカーソルを合わせ、削除アイコンをクリックします。
確認を求めるメッセージが表示されます。削除をクリックしてデータ接続を削除します。そのデータ接続に依存するデータソースがある場合は、通知が表示されます。
Once all dependent data sources are removed—either via the UI or API—try deleting the data connection again.

保存された資格情報¶

資格情報の管理タイルから資格情報を管理する代わりに、データ接続を操作する際に資格情報を管理することも可能です。資格情報タブでは、その接続に関連付けられた資格情報の選択や削除ができ、接続設定タブでは、新しい資格情報を作成できます。

資格情報を作成¶

新しい保存済み資格情報を作成するには：

左側のパネルからデータ接続を選択し、接続設定タブで新しい資格情報をクリックします。
資格情報のタイプと、資格情報を手動で設定するか、共有されたセキュアな構成を使用するかを選択します。
新しい資格情報を入力し、保存をクリックします。必要に応じて、新しい資格情報をテストできます。

資格情報を削除¶

データ接続タイルから接続を選択し、資格情報タブをクリックします。この接続で使用したい資格情報の横にあるアクションメニュー をクリックし、選択をクリックします。現在その接続に関連付けられている資格情報には、「選択済み」のバッジが表示されます。

データ接続を作成するユーザーとエンドユーザーが異なる場合や、データ接続に複数のエンドユーザーがいる場合があるため、DataRobotは各エンティティにユーザーレベルの権限を設定する機能を提供しています。次のようなシナリオを実行できます。

選択したデータエンティティのアクセス権を設定して、さまざまなユーザーにコンシューマーレベル、エディターレベル、または所有者レベルのアクセスを付与することもできます。また、特定のユーザーのアクセスを削除することも可能です。
データ接続を他のユーザーと共有したユーザーは、使用可能なエンティティのリストの下に共有エンティティを共有することができます。

ユーザー、ユーザーグループ、または組織を招待してデータ接続を共有する場合、選択した各ターゲットにはデフォルトの役割であるエディターが割り当てられます（すべてのエンティティは特定のユーザーの役割で共有されます）。役割は、ドロップダウンメニューから変更することができます。

データ接続を共有するには：

右上にあるアカウントメニューでデータ接続を選択し、データ接続を選択して、右上隅にある共有をクリックします。

あるいは、左側のパネルで接続名にカーソルを合わせ、共有アイコンをクリックすることもできます。
追加するメールアドレス、グループ名、または組織を入力して、役割を選択します。ボックスをクリックして共有権限を付与します。
共有をクリックして、ユーザー、ユーザーグループ、または組織を追加します。
必要な数のコラボレーターを追加した後、閉じるをクリックして共有ダイアログボックスを閉じます。

権限によっては、追加されたユーザーを削除することやアクセスを変更することができます。詳細については、ロールと権限の表を参照してください。

備考

各エンティティには、少なくとも1人のオーナーが必要です。自分が唯一のコラボレーションオーナーである場合、自分を削除することや自分の共有権限を削除することはできません。

ラングリングとSQLエディターのための接続サポート¶

DataRobotで現在サポートされているすべてのコネクターおよびJDBCドライバーに接続して、データを追加できます。 Snowflake、BigQuery、Databricksの接続ではプッシュダウンラングリングが使用され、その他のすべての接続ではSparkラングリングが使用されます。

以下の表は、各ラングリング方法でサポートされる機能をまとめたものです。

ラングリング方法	スナップショットデータセット	動的データセット	ライブプレビュー	ラングリング	ソース内マテリアライズ
プッシュダウンラングリング：Snowflake、BigQuery、Databricks		✔	✔	✔	✔
Sparkラングリング：ローカルファイル、公開URL、およびすべてのサポートされている接続からアップロードされたスナップショット	✔			✔

JDBCドライバーの場合、動的データセットに対して特徴量探索を追加および実行できますが、（ラングラーまたはSQLエディターを使用した）データのプレビューとラングリングはサポートされていません。これらの機能を使用するには、まずデータセットのスナップショットを作成する必要があります。

タイプ	説明	推奨される使用方法
コネクター	DataRobotは、DataRobotが構築・保守する連携を利用し、データストアのネイティブAPIを介して接続します。接続はJDBC URLではなく接続フィールドによって定義され、OAuthやサービスプリンシパルなどの認証方式に対応しています。また、多くのデータストアにおいて、非構造化データの取り扱いもサポートしています。コネクターには、登録済みのデータストアが必要です。	接続や資格情報を一度設定して再利用したい場合に推奨されます。また、資格情報やその他の機密性の高い設定をDataRobot内に保存し、コードに埋め込んではならない場合にも、コネクターが推奨される選択肢となります。さらに、レイテンシーが低く、非構造化データをサポートしているため、すべてのエージェントワークフローにおいてもコネクターが推奨されます。
レガシーJDBCドライバー	DataRobotは、データベースベンダーが提供するJDBCドライバーを使用して接続します。接続はJDBC URLおよびJDBCパラメーターによって定義され、基本資格情報による認証を行い、構造化（表形式）データをサポートします。セルフマネージドAIプラットフォームの環境では、管理者がドライバーファイルをアップロードし、管理します。登録済みのデータストアが必要です。	コネクターやDataRobot管理のJDBCドライバーではサポートされていない、カスタム接続タイプにのみ推奨されます。
DataRobotが管理するJDBCドライバー	DataRobotは、インストールの一環としてドライバーセットを提供・管理しています（`browser-jdbc`サービスにバンドルされています）。従来のドライバーとの主な違いは3つあります。データストアは不要です。アクセスは、パブリックエンドポイント`/api/v2/jdbcPreviewQuery`（およびその書き込み用エンドポイント `/api/v2/jdbcExecuteUpdate`）を介して行われます。呼び出し元は、JDBC URL、資格情報、およびSQLを直接渡します。これは、最もレイテンシーの低い経路です。管理者がアップロードしたドライバーは使用しません。あらかじめ定義された、DataRobotが管理するドライバーセットを利用します。基本資格情報だけでなく、ドライバー自体がサポートするあらゆる認証方式に対応しています。資格情報と接続プロパティは、JDBC URLパラメーターとして渡されます。このドライバーは現在、Postgres、MySQL、SQL Server、BigQuery、Snowflake、Databricks、Trino、SAP Datasphereのドライバーに対応しています。	コード内で接続設定や資格情報を直接管理する準備ができている場合に推奨されます。