Virtual Schemas (formerly Workspaces)

​

概要

仮想スキーマは、Connect AI 内の特定のデータ（アセット）を整理、カタログ化し、アクセスを制御する方法を提供します。スケーラブルな方法で、関連するアセットを個別まとめることができます。仮想スキーマは、多くのビジネス機能にわたってデータ分析を合理化する、カスタマイズ可能な組織スキームを提供します。 Connect AI データカタログでは、仮想スキーマのカラムメタデータのプレビューを見ることができます。 仮想スキーマのアセットには、以下のものがあります。

• Folders–仮想スキーマ内に1階層のフォルダを作成できます。
• Tables and Views–接続されたConnect AI データソースのテーブルとビュー
• Derived Views–Connect AI の1つまたは複数のデータソースから派生

テーブル、ビュー、およびDerived View は、変換なしで直接公開されるため、カラム名やその他のプロパティは同じままです。任意のテーブル、ビュー、Derived View を、任意の数の仮想スキーマに追加できます。これらは一意のAlias で参照できます。仮想スキーマであるテーブルは、完全なCRUD 機能をサポートします。

​

仮想スキーマを追加

仮想スキーマは組織の最上位レベルです。さまざまなビジネスニーズに合わせてカスタマイズできます。マーケティングやデータサイエンスなどのビジネスユニットは、それぞれ独立した仮想スキーマを持つことができます。セールスは、クライアントごとに仮想スキーマのフォルダを整理することが可能です。各チームはそれぞれに最適な構造を選択できます。 まず、次の手順で仮想スキーマを作成します。 Virtual Schema に名前と説明を設定すると、SQL Server、OData、 およびOpenAPI Endpoints が自動的に生成されます。エンドポイントは、仮想スキーマの基盤を形成するさまざまな接続への扉です。 仮想スキーマから仮想SQL Server、OData、またはOpenAPI 経由で接続するためのコネクションの詳細を表示するには、View Endpoints をクリックします。Endpoints ダイアログには、Virtual SQL Server 用、OData 用、OpenAPI 用の3つのタブがあります。

​

インバウンド接続

クライアントアプリケーションからConnect AI に接続する場合、仮想スキーマ固有のエンドポイントを介して仮想スキーマに直接接続できます。Connect AI は、REST API、仮想SQL Server、OData、OpenAPI など、インバウンド接続用の複数のエンドポイントをサポートしています。例えば、VirtualSchema.Folder.Asset のように、仮想スキーマ名、フォルダ名、アセット名の間にデフォルトでピリオドを置く設定可能な命名構造によって、エンドポイントを素早く特定できます。 Connect AI はOpenAPI 仕様バージョン2.0と3.0をサポートしているため、OpenAPI と統合するノーコード / ローコードアプリケーションを接続できます。Connect AI を使用すると、仮想スキーマからOpenAPI ドキュメントをダウンロードし、そのファイルをクライアントアプリケーションにインポートすることで、OpenAPI 経由で仮想スキーマに接続できます。

​

REST API に接続

REST API に接続するには、”workspace” という名前のREST API URL にURL パラメータを追加します。これを、クエリする仮想スキーマの名前に設定します。これはメタデータエンドポイントのGET 処理と、クエリおよびバッチエンドポイントのPOST 処理の両方で機能します。/exec エンドポイントは仮想スキーマをサポートしていないことに注意してください。

​

仮想SQL Server 経由で接続

Endpoints ダイアログのVirtual SQL Server タブには、仮想SQL Server クライアントを介して仮想スキーマから接続するために必要な設定が含まれています。ダイアログの設定をコピーします。

• Username—仮想スキーマに接続するためのユーザー名の形式は、[your_email_address]@[virtual_schema_name] です。
• SQL Server Host Name—SQL Server のホスト名（tds.cdata.com）。
• Port—SQL Server のポート（14333）。
• Database—仮想スキーマの名前（必要な場合）。
• Password—認証時にパスワードとして使用するパーソナルアクセストークン（PAT）を作成するには、Create PAT をクリックします。

​

OData 経由で接続

Endpoints ダイアログのOData タブには、OData クライアントを介して仮想スキーマから接続するために必要な設定が含まれています。ダイアログの設定をコピーします。

• Username—仮想スキーマに接続するためのユーザー名は、E メールアドレス形式です。
• OData URL—接続先の仮想スキーマ名。URL の形式は、https://cloud.cdata.com/api/odata/{virtual_schema_name} です。
• Password—認証時にパスワードとして使用するパーソナルアクセストークン（PAT）を作成するには、Create PAT をクリックします。

​

OpenAPI 経由で接続

Endpoints ダイアログのOpenAPI タブには、OpenAPI を介して仮想スキーマから接続するために必要な設定が含まれています。選択した仮想スキーマのOpenAPI 仕様ファイルを生成できます。このファイルは、OpenAPI を介してConnect AI と統合するためにクライアントアプリケーションで使用することができます。

​

開発ツールに接続（JDBC / ODBC / SSIS）

仮想スキーマからCData 開発ツールに接続するには、Connect AI のドライバーのAdvanced タブにあるWorkspace フィールドに仮想スキーマ名を入力します。以下はJDBC ドライバーの例です。

​

接続認証

認証を行うには、Connect AI のE メールアドレスをユーザー名として使用します。パスワードとして使用するためのパーソナルアクセストークン（PAT）が必要です。Endpoints ダイアログまたはSettings ページでPAT を生成できます。

​

仮想スキーマのアセット

仮想スキーマ内に作成されたアセットは特定のデータ項目にリンクし、組織の2番目のレイヤーを提供します。アセットをフォルダに整理できますが、サブフォルダは作成できません。アセットの左側には、アセットがフォルダ、テーブル、またはDerived View のいずれであるかを示すアイコンがあります。アセットの右側には、アセットのデータソースを表示するアイコンがあります（Derived View には適用されません）。 仮想スキーマ内にアセットを作成するには： 仮想スキーマ内のアセットをクリックすると、水平タブに以下の機能が表示されます。

• Columns–カラムのメタデータを含むテーブル
• Preview–接続されたデータ項目の内容をプレビューテーブルに表示
• SQL–テーブル、ビュー、またはDerived View に対して生成された参照SQL クエリ。クエリ時に重要な参照となる設定可能なAlias が含まれます。

​

データモデル

データモデルは、VirtualSchema.Folder.Table 設計に従っています。階層にフォルダが存在しない場合は、[ROOT] と表示されます。データモデルについて詳しくは、SQL リファレンスを参照してください。