Microsoft Azure Synapse SQLコネクタ > Microsoft Azure Synapse SQLの接続 > Microsoft Azure Synapse SQLへの接続
  

Microsoft Azure Synapse SQLへの接続

Microsoft Azure Synapse SQLに接続するようにMicrosoft Azure Synapse SQL接続プロパティを設定してみましょう。

始める前に

開始する前に、設定する認証タイプに基づいてMicrosoft Azure Synapse SQLアカウントから情報を取得する必要があります。
必要な情報については、Microsoft Azure Synapse SQLの「Azure Active Directory認証」、「マネージドID認証」、および「サービスプリンシパル認証」を参照してください。
AzureアカウントからJDBC URLを取得する方法については、How-Toライブラリの記事「Obtaining the JDBC URL」を参照してください。
サーバーレスSQLプールに接続するために必要な情報については、「サーバーレスSQLプール」を参照してください。

接続の詳細

次の表に、基本接続プロパティを示します。
プロパティ
説明
接続名
接続の名前。
各接続名は組織内で一意である必要があります。接続名には、英数字、スペース、および次の特殊文字を含めることができます。_ .+ -,
最大長は255文字です。
説明
接続の説明。最大長は4000文字です。
タイプ
Microsoft Azure Synapse SQL
ランタイム環境
タスクを実行するランタイム環境の名前。
Secure Agent、ホステッドエージェント、またはサーバーレスランタイム環境を選択します。
ホステッドエージェントは、詳細モードのマッピングには適用されません。
Azure DW JDBC URL
Microsoft Azure Synapse SQL JDBC接続文字列。
次の文字列を使用して、Microsoft Azure Synapse SQLに接続します。
jdbc:sqlserver://<Server>.database.windows.net:1433;database=<Database>
接続文字列に認証パラメータを含めて、認証タイプを指定できます。Microsoft Azure Synapse SQLに接続するための次の認証タイプを設定できます。
  • - Microsoft SQL Server
  • - Azure Active Directory
  • - マネージドID
  • - サービスプリンシパル
接続文字列に認証パラメータを含めない場合、Secure Agentでは認証タイプとしてMicrosoft SQL Server認証が使用されます。
Microsoft Azure Synapse SQLのサーバーレスSQLプールに接続するには、次の文字列を使用します:
jdbc:sqlserver://<サーバーレスSQLエンドポイント>:1433;database=<データベース>;Authentication=ActiveDirectoryMsi;
Microsoft SQL Server認証の接続文字列形式
jdbc:sqlserver://<Server>.database.windows.net:1433;database=<Database>
Azure Active Directory（AAD）認証の接続文字列形式
jdbc:sqlserver://<サーバー>.database.windows.net:1433; database=<データベース>;encrypt=true;trustServerCertificate=false; hostNameInCertificate=*.database.windows.net;loginTimeout=30; Authentication=ActiveDirectoryPassword;
サービスプリンシパル認証の接続文字列形式
jdbc:sqlserver://<Server>.database.windows.net:1433; database=<Database>;encrypt=true;trustServerCertificate=false; hostNameInCertificate=*.database.windows.net;loginTimeout=30; Authentication= ActiveDirectoryServicePrincipal;
マネージドID認証の接続文字列形式
jdbc:sqlserver://<サーバー>.database.windows.net:1433;database=<データーベース>;Authentication=ActiveDirectoryMsi;
Azure DW JDBCユーザー名
Microsoft Azure Synapse SQLアカウントに接続するためのユーザー名。
  • - AAD認証の場合は、AADユーザー名を指定します。
  • - Microsoft SQL Server認証の場合は、SQL認証ユーザー名を指定します。
  • - サービスプリンシパル認証の場合は、Azure Active Directoryに登録されているアプリケーションのアプリケーションIDまたはクライアントIDを指定します。
このプロパティは、マネージドID認証には適用されません。
Azure DW JDBCパスワード
Microsoft Azure Synapse SQLアカウントに接続するためのパスワード。
  • - AAD認証の場合は、AADユーザーのパスワードを指定します。
  • - Microsoft SQL Server認証の場合は、SQL認証ユーザーのパスワードを指定します。
  • - サービスプリンシパル認証の場合は、Azure Active Directoryに登録されているアプリケーションのクライアントシークレットを指定します。
このプロパティは、マネージドID認証には適用されません。
Azure DWクライアントID
マネージドID認証でユーザー割り当てマネージドIDを使用してMicrosoft Azure Synapse SQLに接続する場合は必須です。
ユーザー割り当てマネージドIDのクライアントID。
システム割り当てのマネージドIDを使用する場合は、フィールドを空のままにします。
Azure DWスキーマ名
Microsoft Azure Synapse SQL内のスキーマの名前。

Azureストレージタイプ

データファイルをステージングするAzureストレージタイプとして、Microsoft Azure Blob StorageまたはMicrosoft Azure Data Lake Storage Gen2を選択できます。デフォルトはAzure Blobです。
希望するストレージタイプを選択し、ストレージ固有のパラメータを設定します。
Microsoft Azure Blob StorageまたはMicrosoft Azure Data Lake Storage Gen2に接続してファイルをステージングするときに、共有キー認証の資格情報を取得する方法については、How-Toライブラリの記事「Get credentials for shared key authentication」を参照してください。
Microsoft Azure Data Lake Storage Gen2に接続してファイルをステージングするときに、サービスプリンシパル認証の資格情報を取得する方法については、How-Toライブラリの記事「Get credentials for service principal authentication」を参照してください。

詳細設定

次の表に、詳細接続のプロパティを示します。
プロパティ
説明
外部データソース
外部テーブルを作成するデータソース。
外部データソースがMicrosoft Azure Synapse SQLに存在していること、および外部データソースにアクセスする権限があることを確認してください。
コピーコマンド方式を使用してステージングの場所からMicrosoft Azure Synapse SQLにデータのロードを行う場合、外部データソースを指定する必要はありません。
ステージングスキーマ名
Secure Agentがデータファイルをステージングする外部テーブルを作成するのに使用するスキーマの名前。
ステージングスキーマ名が指定されていない場合、Secure Agentは設定されたAzure DWスキーマ名を考慮します。
Blobエンドポイント
Microsoft Azureエンドポイントのタイプ。
次のいずれかのエンドポイントを選択します。
  • - core.windows.net。Azureエンドポイントに接続します。サーバーレスSQLプールに接続する場合は、このエンドポイントを使用します。
  • - core.usgovcloudapi.net。米国政府のMicrosoft Azure Synapse SQLエンドポイントに接続します。
  • - core.chinacloudapi.cn。中国地域のMicrosoft Azure Synapse SQLエンドポイントに接続します。
デフォルトはcore.windows.netです
VNetルール
仮想ネットワーク（VNet）にあるMicrosoft Azure Synapse SQLエンドポイントへの接続を有効にします。
このプロパティは、サーバーレスランタイム環境には適用されません。