Microsoft SQL Serverへの接続

プロパティ	説明
接続名	接続の名前。各接続名は組織内で一意である必要があります。接続名には、英数字、スペース、および次の特殊文字を含めることができます。_ .+ -, 最大長は255文字です。
説明	接続の説明。最大長は4000文字です。
シークレットコンテナの使用	組織に対して設定されているSecrets Managerにこの接続の機密資格情報を保存します。このプロパティは、組織にSecrets Managerが設定されている場合にのみ表示されます。接続でシークレットコンテナを有効にすると、Secure AgentがSecrets Managerからどの資格情報を取得するかを選択できます。このオプションを無効にした場合、資格情報は組織の設定方法に応じてリポジトリまたはローカルSecure Agentに保存されます。注: この接続を使用してプッシュダウンまたはプロキシサービスを介してデータアクセスポリシーを適用する場合、シークレットコンテナ設定オプションを使用することはできません。 Secrets Managerを設定および使用する方法については、Secrets manager configurationを参照してください。
ランタイム環境	タスクを実行するランタイム環境の名前。 Secure Agent、ホステッドエージェント、サーバーレスランタイム環境、またはエラスティックランタイム環境を選択します。ランタイム環境の設定および使用方法の詳細については、Administratorのヘルプにある「ランタイム環境」を参照してください。
SQL Serverのバージョン	このプロパティは使用されなくなりました。バージョンを選択しても、選択したバージョンは無視されます。

認証モード

SQL Serverの認証

SQL Server認証ではMicrosoft SQL ServerにアクセスするためのMicrosoft SQL Serverのユーザー名とパスワードを使用します。

次の表に、SQL Server認証の基本接続プロパティとその説明を示します。

プロパティ	説明
ユーザー名	データベースログインに使用するユーザー名。ユーザー名にセミコロンを含めることはできません。 Microsoft Azure SQL Databaseに接続するには、次の形式でユーザー名を指定します: username@host
パスワード	データベースログインに使用するパスワード。パスワードにセミコロンを含めることはできません。
ホスト	データベースサーバーをホストするマシンの名前。 Microsoft Azure SQL Databaseに接続するには、完全修飾ホスト名を指定します。例えば、vmjcmwxsfboheng.westus.cloudapp.azure.comのように指定します。
ポート	データベースサーバーに接続するときに使用するネットワークポート番号。デフォルトは1433です。
インスタンス名	Microsoft SQL Serverデータベースのインスタンス名。
データベース名	Microsoft SQL Serverターゲット接続のデータベース名。データベースで大文字と小文字が区別される場合は、データベース名の大文字と小文字も区別されます。最大長は100文字です。データベース名には英数字とアンダースコアのみを使用できます。
スキーマ	マッピングでのオブジェクト選択時にテーブルを選択するためのスキーマ名。マッピング内のオブジェクトを選択すると、アクセス権を持つすべてのスキーマが表示され、使用可能なスキーマからテーブルを選択できます。
コードページ	データベースサーバーのコードページ。
ドメイン	このプロパティはSQL Server認証には適用されません。

Windows認証

Windows認証（非推奨）ではMicrosoft SQL ServerにアクセスするためにMicrosoft Windows認証を使用します。このオプションは、Microsoft Windowsを使用してデータ統合にアクセスする場合に使用できます。

このオプションを選択する場合、Microsoft SQL Serverにアクセスするために資格情報を入力する必要はなく、Secure Agentサービスを開始するユーザーアカウントが、Microsoft SQL Serverデータベースで使用可能になっていることを確認します。

注: Windows認証は、LinuxでホストされるMicrosoft SQL Server 2017バージョンでは使用できません。サーバーレスランタイム環境を使用している場合、Windows認証を設定することはできません。

次の表に、Windows認証の基本接続プロパティとその説明を示します。

プロパティ	説明
ホスト	データベースサーバーをホストするマシンの名前。 Microsoft Azure SQL Databaseに接続するには、完全修飾ホスト名を指定します。例えば、vmjcmwxsfboheng.westus.cloudapp.azure.comのように指定します。
ポート	データベースサーバーに接続するときに使用するネットワークポート番号。デフォルトは1433です。
インスタンス名	Microsoft SQL Serverデータベースのインスタンス名。
データベース名	Microsoft SQL Serverターゲット接続のデータベース名。データベースで大文字と小文字が区別される場合は、データベース名の大文字と小文字も区別されます。最大長は100文字です。データベース名には英数字とアンダースコアのみを使用できます。
スキーマ	マッピングでのオブジェクト選択時にテーブルを選択するためのスキーマ名。マッピング内のオブジェクトを選択すると、アクセス権を持つすべてのスキーマが表示され、使用可能なスキーマからテーブルを選択できます。
コードページ	データベースサーバーのコードページ。
ドメイン	このプロパティはWindows認証には適用されません。

Active Directoryパスワード認証

Active Directoryパスワード認証では、Azure Active Directoryのユーザー名とパスワードを使用して、Microsoft Azure SQLデータベースの認証とアクセスを行います。

次の表に、Active Directoryパスワード認証の基本的な接続プロパティとその説明を示します。

プロパティ	説明
ユーザー名	データベースログインに使用するユーザー名。ユーザー名にセミコロンを含めることはできません。 Microsoft Azure SQL Databaseに接続するには、次の形式でユーザー名を指定します: username@host
パスワード	データベースログインに使用するパスワード。パスワードにセミコロンを含めることはできません。
ホスト	データベースサーバーをホストするマシンの名前。 Microsoft Azure SQL Databaseに接続するには、完全修飾ホスト名を指定します。例えば、vmjcmwxsfboheng.westus.cloudapp.azure.comのように指定します。
ポート	データベースサーバーに接続するときに使用するネットワークポート番号。デフォルトは1433です。
インスタンス名	Microsoft SQL Serverデータベースのインスタンス名。
データベース名	Microsoft SQL Serverターゲット接続のデータベース名。データベースで大文字と小文字が区別される場合は、データベース名の大文字と小文字も区別されます。最大長は100文字です。データベース名には英数字とアンダースコアのみを使用できます。
スキーマ	マッピングでのオブジェクト選択時にテーブルを選択するためのスキーマ名。マッピング内のオブジェクトを選択すると、アクセス権を持つすべてのスキーマが表示され、使用可能なスキーマからテーブルを選択できます。
コードページ	データベースサーバーのコードページ。
ドメイン	このプロパティは、Active Directoryパスワード認証には適用されません。

Windows認証v2

Windows認証V2では、LinuxまたはWindowsマシンでホストされているエージェントを使用しているデータ統合からMicrosoft SQL Serverにアクセスします。

Linuxでこのオプションを選択する場合は、ドメイン名とMicrosoft Windows資格情報を入力してMicrosoft SQL Serverにアクセスします。

Windowsでこのオプションを選択すると、エージェントは接続で指定されたユーザー資格情報のみを使用して接続をテストします。実行時に、エージェントはSecure Agentサービスを開始したユーザーの資格情報を使用します。Secure Agentサービスを開始するユーザーアカウントが、Microsoft SQL Serverデータベースで使用可能になっていることを確認します。

注: サーバーレスランタイム環境を使用している場合、Windows認証を設定することはできません。

次の表に、Windows認証v2の基本接続プロパティとその説明を示します。

プロパティ	説明
ユーザー名	データベースログインに使用するユーザー名。ユーザー名にセミコロンを含めることはできません。 Microsoft Azure SQL Databaseに接続するには、次の形式でユーザー名を指定します: username@host WindowsでWindows認証v2を使用した場合、ユーザー名は次のように使用されます。 - 設計時に、エージェントはここで指定したユーザー名を使用して接続をテストします。 - 実行時に、Microsoft SQL Serverドライバは、このフィールドに指定されたユーザー名を無視し、Secure Agentサービスを開始したユーザーの資格情報を使用します。 LinuxでWindows認証v2を使用した場合、ここで指定したユーザー名は、設計時および実行時に使用されます。
パスワード	データベースログインに使用するパスワード。パスワードにセミコロンを含めることはできません。 WindowsでWindows認証v2を使用する場合、パスワードは次のように使用されます。 - 設計時に、エージェントはここで指定したパスワードを使用して接続をテストします。 - 実行時に、Microsoft SQL Serverドライバは、このフィールドに指定されたパスワードを無視し、Secure Agentサービスを開始したユーザーの資格情報を使用します。 LinuxでWindows認証v2を使用した場合、ここで指定したパスワードは、設計時および実行時に使用されます。
ホスト	データベースサーバーをホストするマシンの名前。 Microsoft Azure SQL Databaseに接続するには、完全修飾ホスト名を指定します。例えば、vmjcmwxsfboheng.westus.cloudapp.azure.comのように指定します。
ポート	データベースサーバーに接続するときに使用するネットワークポート番号。デフォルトは1433です。
インスタンス名	Microsoft SQL Serverデータベースのインスタンス名。
データベース名	Microsoft SQL Serverターゲット接続のデータベース名。データベースで大文字と小文字が区別される場合は、データベース名の大文字と小文字も区別されます。最大長は100文字です。データベース名には英数字とアンダースコアのみを使用できます。
スキーマ	マッピングでのオブジェクト選択時にテーブルを選択するためのスキーマ名。マッピング内のオブジェクトを選択すると、アクセス権を持つすべてのスキーマが表示され、使用可能なスキーマからテーブルを選択できます。
コードページ	データベースサーバーのコードページ。
ドメイン	Windowsユーザーのドメイン名。

Kerberos認証

Kerberos認証を使用してMicrosoft SQL Serverに接続することができます。

Windowsでこのオプションを選択する場合は、Secure Agentサービスを開始するユーザーアカウントが、Microsoft SQL Serverデータベースで使用可能になっていることを確認します。Microsoft SQL Serverにアクセスする際に資格情報を入力する必要はありません。

注: Hosted Agentまたはサーバーレスランタイム環境を使用している場合は、Kerberos認証を設定できません。

次の表に、Kerberos認証の基本接続プロパティとその説明を示します。

プロパティ	説明
ホスト	データベースサーバーをホストするマシンの名前。 Microsoft Azure SQL Databaseに接続するには、完全修飾ホスト名を指定します。例えば、vmjcmwxsfboheng.westus.cloudapp.azure.comのように指定します。
ポート	データベースサーバーに接続するときに使用するネットワークポート番号。デフォルトは1433です。
インスタンス名	Microsoft SQL Serverデータベースのインスタンス名。
データベース名	Microsoft SQL Serverターゲット接続のデータベース名。データベースで大文字と小文字が区別される場合は、データベース名の大文字と小文字も区別されます。最大長は100文字です。データベース名には英数字とアンダースコアのみを使用できます。
スキーマ	マッピングでのオブジェクト選択時にテーブルを選択するためのスキーマ名。マッピング内のオブジェクトを選択すると、アクセス権を持つすべてのスキーマが表示され、使用可能なスキーマからテーブルを選択できます。
コードページ	データベースサーバーのコードページ。
ドメイン	このプロパティは、Kerberos認証には適用されません。

サービスプリンシパル認証

コネクタでSecure AgentインストールディレクトリのLATESTフォルダにあるJDBCおよびODBCドライバが使用されている場合は、サービスプリンシパル認証を設定できます。

注: 接続でシークレットボールトを有効にすると、Microsoft SQL Serverデータベースに接続するようにサービスプリンシパル認証を設定できなくなります。

サービスプリンシパル認証を設定するには、Microsoft Entra IDに登録されているアプリケーションのクライアントIDとクライアントシークレットを取得する必要があります。

次の表に、サービスプリンシパル認証の接続プロパティとその説明を示します。

プロパティ	説明
クライアントID	Microsoft Entra IDに登録されているアプリケーションのクライアントIDまたはアプリケーションID。
クライアントシークレット	Microsoft Entra IDでOAuth認証を完了するためにクライアントID用に生成されたクライアントシークレットキー。
ホスト	データベースサーバーをホストするマシンの名前。 Microsoft Azure SQL Databaseに接続するには、完全修飾ホスト名を指定します。例えば、vmjcmwxsfboheng.westus.cloudapp.azure.comのように指定します。
ポート	データベースサーバーに接続するときに使用するネットワークポート番号。デフォルトは1433です。
インスタンス名	Microsoft SQL Serverデータベースのインスタンス名。
データベース名	Microsoft SQL Serverターゲット接続のデータベース名。データベースで大文字と小文字が区別される場合は、データベース名の大文字と小文字も区別されます。最大長は100文字です。データベース名には英数字とアンダースコアのみを使用できます。
スキーマ	マッピングでのオブジェクト選択時にテーブルを選択するためのスキーマ名。マッピング内のオブジェクトを選択すると、アクセス権を持つすべてのスキーマが表示され、使用可能なスキーマからテーブルを選択できます。
コードページ	データベースサーバーのコードページ。
ドメイン	このプロパティは、サービスプリンシパル認証には適用されません。

詳細設定

プロパティ	説明
暗号化方法	Secure Agentが、ドライバとデータベースサーバーとの間で送信されるデータの暗号化に使用する方法。暗号化方法を使用して、Microsoft Azure SQL Databaseに接続できます。デフォルトは［なし］です。
暗号プロトコルバージョン	SSL暗号化を有効化する際に使用する暗号プロトコル。
サーバー証明書の検証	Trueに設定すると、Secure Agentが、データベースサーバーによって送信された証明書を検証します。 HostNameInCertificateパラメータを指定すると、Secure Agentは証明書内のホスト名も検証します。 Falseに設定すると、Secure Agentは、データベースサーバーによって送信された証明書を検証しません。
トラストストア	トラストストアファイルの場所と名前。トラストストアファイルには、ドライバがSSLサーバー認証に使用する認証局（CA）の一覧が含まれています。サーバーレスランタイム環境の場合、サーバーレスエージェントディレクトリで次の証明書パスを指定します。 /home/cldagnt/SystemAgent/serverless/configurations/ssl_store/<TrustStore_filename>
トラストストアのパスワード	トラストストアファイルの内容にアクセスするためのパスワード。
証明書内のホスト名	セキュアデータベースをホストするマシンのホスト名。ホスト名を指定すると、Secure Agentでは接続に含まれるホスト名をSSL証明書内のホスト名と照らし合わせて検証します。
メタデータの詳細接続プロパティ	JDBCドライバがメタデータを取得するための追加プロパティ。プロパティは次の形式で入力します: <パラメータ名>=<パラメータ値> 複数のプロパティを入力する場合は、それぞれのキーと値のペアをセミコロンで区切ります。例えば、接続をテストするときに接続タイムアウトを設定するには、次のプロパティを入力します: LoginTimeout=<value_in_seconds> 注: デフォルトの接続のタイムアウトは270秒です。
ランタイムの詳細接続プロパティ	ODBCドライバがランタイムに必要とする追加プロパティ。複数のプロパティを指定する場合は、キーと値のペアをそれぞれセミコロンで区切ります。