Microsoft® SQL Server® コネクターを使用すると、チェーンでコマンド を使用して、Microsoft Dynamics® Great Plains® (GP) や Yardi® Private Cloud などのソリューションを含む Microsoft SQL Server データベースで構造化クエリ言語 (SQL) 操作を実行できます。例えば、このコネクターを使えば、次のことができる：
-
CREATEまたはUPDATEステートメントまたはSELECTクエリを含む SQL コマンドを実行する。 - SQL Serverでテーブルの詳細を取得する
- SQL Server データベースへのレコード挿入
メモ: このコネクターはWorkivaによって構築され、サードパーティのシステムに接続する。Workivaサポートチームは、お客様のワークスペース内でこのコネクターの構成をヘルプすることはできますが、Workivaプラットフォーム外で発生した問題のトラブルシューティングやその他のサポートを行うことはできません。
要件
SQL Server データベースへの接続を有効にするために、コネクターは基本ユーザー名とパスワード認証で保護された Java データベース接続（JDBC）を使用します。コネクターの設定には、以下のものが必要だ：
- コネクター用にSQL Serverで作成された指定統合ユーザー
- 統合ユーザーのユーザー名とパスワード
-
jdbc:sqlserver://localhost:1433;[オプション]のようなJDBC接続のURL。 - オンプレミスの SQL Server データベースに接続するには、接続用の GroundRunner
対応バージョン
Microsoft® SQL Server® コネクターは、次のデータベース・バージョンと互換性があります ：
- Azure SQL Database
- Azure Synapse Analytics
- Azure SQL Managed Instance
- SQLサーバー 2022
- SQL Server 2019
- SQL Server 2017
- SQL Server 2016
- SQL Server 2014
Microsoft SQL Server コネクターの設定
注： 組織のチェーンでコネクターを使用できるようにするには、まず最初に組織のセキュリティ管理者が構成から コネクターを有効にする必要があります。
- チェーンビルダー から接続 をクリックし、右上の作成 をクリックします。
-
コネクター 接続 で、Microsoft SQL Server と接続で使用するランナーを選択する。
- [基本情報]で、接続の識別に役立つ一意の名前と説明を入力します。
-
プロパティ で、コネクターの詳細を入力します：
プロパティ 詳細 ユーザー名 コネクターの SQL Server 統合ユーザーのユーザー名を入力します。 パスワード ユーザー名 プロパティのパスワードを入力します。 接続URL jdbc:sqlserver://<server>:<port>のように、JDBC接続のURLを入力します。接続にオプションのプロパティ を含めるには、セミコロンの後にjdbc:sqlserver://localhost:1433;<options>のように追加します。例えば、Active Directory®の統合セキュリティを使用してデータベースに接続する場合：;databasename=<database>;integratedSecurity=True;authenticationScheme=NTLM注： デフォルトでは、ポートは
1433;ですが、お使いの環境によっては異なる場合があります。注：機密性の高い資格情報はすべて自動的に暗号化され、高度な暗号化標準（AES）-256暗号化で保存されます。セキュリティ上、Connection URL プロパティ内にオプションプロパティとしてユーザー認証情報を含むことは避けてください。
- 接続に使用する環境を選択し、保存します。
- 接続をテストするには、 コネクターのテーブル定義を取得コマンドでチェーンを作成して実行し、有効な出力を返すことを確認します。
トラブルシューティング
SQL Serverへの接続に失敗した場合：
- 統合ユーザーの認証情報を確認します。
- サーバーとポートを含むJDBC接続のURLを確認する。
- オンプレミスのデータベースに接続する場合は、コネクターに選択されている GroundRunner を確認してください。
接続がコマンドの実行に失敗した場合は、その入力（SQL構文やテーブルなど）が有効であることを確認する。