Microsoft Azure Synapse Analytics接続

資格情報

Copy link to section

認証方法を選択する：

ユーザー名とパスワード
Microsoft Azure Synapse Analyticsのデータベースにアクセスするためのユーザー名とパスワード。

Entra ID クライアント秘密鍵資格情報

• Client ID: Microsoft Azure へのアクセスを認証するためのクライアント ID。 アプリケーションのクライアント ID を検索するには、Microsoft Entra ID を選択します。 アプリケーション登録から、アプリケーションを選択します。 アプリケーションのクライアントIDをコピーするには、コピーをクリックします。 詳細は、Microsoft Entra アプリの登録とサービスプリンシパルの作成を参照してください。
• クライアントシークレット: Microsoft Azureへのアクセスを認証するためのクライアントIDに関連付けられた認証キー。 アプリケーションのクライアントシークレットを見つけるには、Microsoft Entra ID を選択します。 アプリケーション登録から、アプリケーションを選択します。 Certificates & secrets > Client secrets にアクセスしてください。 既存のクライアントシークレットをコピーするには、コピーをクリックし、新しいクライアントシークレットを作成してコピーするには、新しいクライアントシークレットをクリックします。 詳細は、Microsoft Entra アプリの登録とサービスプリンシパルの作成を参照してください。

Entra ID username password credential
Microsoft Azure アカウントのユーザー名とパスワード。

プライベート接続の場合、インターネットに外部化されていないデータベース (例えば、ファイアウォールの内側) に接続するには、 セキュア接続をセットアップする必要があります。

IBM Cloud Satellite で接続する場合は、Azure SQL Database に接続するために、Azureサーバーでプロキシ接続ポリシーを設定する必要があります。 詳細については、Azure SQL Database接続アーキテクチャを参照してください。

プラットフォーム内の場所に基づいて接続を作成する方法を選択してください

Copy link to section

プロジェクト内

資産] > [新規資産] > [ソースに接続データ] をクリックします。 プロジェクトに接続を追加するを参照してください。

カタログに掲載

「カタログに追加」>「接続」をクリックしてください。 接続アセットをカタログに追加するを参照してください。

配備スペースにて

資産のインポート > データアクセス > 接続をクリックします。 詳細は、配置スペースにデータ アセットを追加するを参照してください。

Platform assets catalogにある

新規接続をクリックしてください。 プラットフォーム接続の追加を参照してください。

次のステップ: 接続からデータ資産を追加する

Copy link to section

• プロジェクトでの接続からのデータの追加を参照してください。

• カタログ内の接続からのデータの追加を参照してください。

SQL ステートメントの実行

Copy link to section

SQL ステートメントが正しく実行されるように、Azure Synapse SQL ドキュメントで正しい構文を確認してください。

リネージュメタデータのインポート範囲

Copy link to section

インクルードリストと除外リスト

資産をスキーマ・レベルまで含める/除外することができます。 データベースとスキーマをデータベース/スキーマ形式で指定します。 各部品は正規表現として評価されます。 データ・ソースに後から追加された資産も、リストで指定された条件に一致すれば、含まれます/除外されます。 値の例：

• myDB/ myDB データベースのすべてのスキーマ。
• myDB2/.* myDB2 データベースのすべてのスキーマ。
• myDB3/mySchema1: myDB3 データベースから mySchema1 スキーマ。
• myDB4/mySchema[1-5] mySchema で始まり、1 から 5 までの数字で終わる名前を持つ、私の データベース内の任意のスキーマ。 myDB4

外部入力

接続されたデータベースから直接抽出されない外部の Microsoft Azure Synapse Analytics SQLスクリプトやT-SQLスクリプトを使用する場合は、外部入力としてZIPファイルに追加できます。 zipファイルの構造をデータベースやスキーマを表すサブフォルダーとして編成できます。 スクリプトがスキャンされると、選択したカタログまたはプロジェクト内の各データベースおよびスキーマの下に追加されます。 ZIPファイルは以下のような構造になっています：

    <database_name>
        <schema_name>
           <script_name.sql>
    <database_name>
        <script_name.sql>
    <script_name.sql>
    replace.csv
    linkedServerConnectionsConfiguration.prm
Copy to clipboardクリップボードにコピーされました

replace.csv ファイルには、ZIP ファイルに追加されるスクリプトのプレースホルダー置換が含まれています。 フォーマットの詳細については、 プレースホルダーの置換を参照のこと。

linkedServerConnectionsConfiguration.prm ファイルには、リンクされたサーバー接続定義が含まれている。 以下の構造は、1つの接続を定義するものである：

[{Shortcut_Name}] Type={connection_type}
Connection_String={connection_string}
Server_Name={server_name}
Database_Name={database_name}
Schema_Name={schema_name}
User_Name={user_name}
Copy to clipboardクリップボードにコピーされました

高度なメタデータ・インポート・オプション

Copy link to section

拡張属性の抽出

カラムの主キー、一意性、参照整合性制約のような拡張属性を抽出することができます。 デフォルトでは、これらの属性は抽出されない。

抽出モード

インポートしたメタデータに対して実行する抽出モードを決定できます。 次のオプションがあります。

• プリフェッチ：リレーショナル・データベースに使う。
• パラレル・バルク: 分析処理エンジンに使用します。
• シングル・スレッド: 抽出中の並列処理や大規模なクエリーを避けるために使用します。 このモードを選択した場合、パフォーマンスが低下する可能性があります。

変換ロジックの抽出

SQL スクリプトで、SQL コードから変換ロジック記述を構築できるようにすることができます。