Kerberos を使用して、異なる OS で Microsoft SQL Server データソースを作成する
Database Tools and SQL プラグインを有効化
この機能は、JetBrains Rider にデフォルトでバンドルされ有効化されている Database Tools and SQL プラグインに依存しています。 関連機能が利用できない場合は、プラグインを無効化していないことを確認してください。
Ctrl+Alt+S を押して設定を開き、 を選択します。
インストール済み タブを開き、 Database Tools and SQL プラグインを見つけて、プラグイン名の横にあるチェックボックスを選択します。
公式ドキュメントとソフトウェア
Microsoft SQL Server の詳細については、 公式ドキュメントを参照してください。
Microsoft SQL Server データベースソフトウェアをダウンロードするには、 公式ソフトウェアダウンロードを参照してください。
このトピックでは、JetBrains Rider から Microsoft SQL Server のデータソースを作成する方法の例を紹介します。 Windows、 macOS 、および Linux での JetBrains Rider の構成について説明します。
Windows ドメイン認証を使用する チェックボックスは Windows でのみ使用可能であることに注意してください。 macOS および Linux で Windows ドメイン認証を構成するには、 Windows ドメイン認証を使用して接続する を参照してください。
必要な設定
Microsoft SQL Server は専用ポートで TCP/IP 接続を受け付けます。 デフォルトではポート 1433 が Microsoft の Windows ファイアウォールによって閉じられています。 ポート経由で接続する場合は、ファイアウォールが使用するポートを閉じていないことを確認してください。
SQL Server ブラウザーがオンの場合は、Microsoft SQL Server インスタンス名を使用して TCP/IP 接続を確立することもできます。
TCP/IP 接続を有効にして構成する
公式の手順に従ってプロトコルを有効にし、ポート番号を確認して割り当てます。 他の実行中のアプリケーションが同じポートを使用していないことを確認してください。
Microsoft SQL Server インスタンスの名称は MSSQLSERVER です。 デフォルトのポートは
1433です。
Kerberos を使用して接続する
Kerberos 認証を使用して Microsoft SQL Server データベースへ接続する前に、コマンドプロンプトまたは ターミナルで Kerberos コマンドを実行し、認証チケットが取得できていることを確認してください。
マシンにチケットキャッシュファイルがあり、
useTicketCacheがtrueに設定されている場合は、klistコマンドを実行してください。 キャッシュされたチケットの中に、あなたのチケットが含まれていることを確認してください。マシン上でチケットキャッシュが有効になっていない場合は、次の手順を実行します。
klistコマンドを実行し、チケットがリストされていることを確認します。認証チケットがリストにない場合は、ユーザー名を指定して
kinitコマンドを実行し、サーバーkinit sqlsrvkrbからチケットを取得してください。sqlsrvkrbの代わりにユーザー名を使用してください。 プロンプトが表示されたら、パスワードを入力してください。
Kerberos チケットの詳細については、 Kerberos Web サイト(英語)を参照してください。
データソースを作成する
データベースに接続するには、接続の詳細を保存するデータソースを作成します。
データベース ツールウィンドウで、
新規 をクリックし、 データベースに接続する を選択します。ソリューションまたはその他の場所でデータベースの接続文字列が定義されている場合は、 接続文字列を使用する オプションを選択したままにし、 データベースタイプ セレクターで %microsoft_sql% を選択します。
文字列 セレクターを使用して、ソリューションから目的の接続文字列を選択するか、手動で入力して、 接続 をクリックします。
データソースを手動で追加する を選択し、 次へ をクリックして、 データベースソース セレクターで %microsoft_sql% を選択することもできます。 ウィザードの手順に従って、個々のオプションを構成して接続文字列を形成します。
新しいデータベース接続で使用可能なすべてのオプションにアクセスするには、 データベース ウィンドウで
をクリックし、次に 新規 をクリックして、 %microsoft_sql% を選択します。ドライバー リンクをクリックし、接続用のドライバーを選択します。
接続設定エリアの下部に「不足しているドライバーファイルをダウンロード 」リンクがあるかどうかを確認してください。 このリンクをクリックすると、データベースとのやり取りに必要なドライバーをダウンロードできます。 直接ダウンロードリンクについては、 JetBrains JDBC ドライバーページを参照してください。
ダウンロードされた JDBC ドライバーの場所は JetBrains Rider 構成ディレクトリです。
提供されているドライバーの代わりにデータベース用のドライバーを使用することもできます。 ドライバーを使用したデータベースへの接続の詳細については、「既存の接続にユーザードライバーを追加する 」を参照してください。
不足しているドライバーファイルをダウンロード リンクがない場合は、必要なドライバーがすでに存在します。
データベース接続の詳細を指定します。 あるいは、JDBC URL を URL フィールドに貼り付けます。
ホスト、 インスタンス、 ポート フィールドに接続の詳細を指定します。
認証 リストから Kerberos を選択してください。
ユーザー フィールドと パスワード フィールドにユーザー資格情報を入力します。
パスワードを使用しない場合は、 パスワード フィールドを空のままにします。
一度入力したパスワードを削除するには、「パスワード 」フィールドを右クリックし、「空にする 」を選択します。
データベース フィールドに、接続先のデータベース名を入力します。
提供された詳細情報を使用してデータベース接続を確立できることを確認してください。 これを行うには、接続詳細セクションの下部にある 接続のテスト リンクをクリックしてください。
接続の問題が発生した場合は、 データベースに接続できません ページを参照してください。
(オプション) デフォルトでは、デフォルトのデータベースとスキーマのみがイントロスペクトされ、使用可能になります。 他のデータベースやスキーマも操作したい場合は、「スキーマ 」タブで、イントロスペクション用に選択します。
OK をクリックして、データソースを作成します。
データベース ツールウィンドウで新しいデータソースを見つけます。
データベース ツールウィンドウの詳細については、対応する リファレンストピックを参照してください。
JetBrains Rider でのデータベースオブジェクトの操作の詳細については、 データベースオブジェクト を参照してください。
クエリを作成して実行するには、データソースをクリックして F4 を押し、既定の クエリコンソールを開きます。
データベースオブジェクトのデータを表示および編集するには、オブジェクトをダブルクリックして データエディターとビューアー を開きます。
Windows
SQL Server 認証を使用して接続する
データベース ツールウィンドウ () で、 データソースのプロパティ アイコン
をクリックします。 または、 Shift+Enter を押します。データソースおよびドライバー ダイアログで、 追加 アイコン（
）をクリックし、 %microsoft_sql% を選択します。ドライバー リンクをクリックし、 %microsoft_sql% (jTds) を選択します。
接続設定エリアの下部に「不足しているドライバーファイルをダウンロード 」リンクがあるかどうかを確認してください。 このリンクをクリックすると、データベースとのやり取りに必要なドライバーをダウンロードできます。 直接ダウンロードリンクについては、 JetBrains JDBC ドライバーページを参照してください。
ダウンロードされた JDBC ドライバーの場所は JetBrains Rider 構成ディレクトリです。
提供されているドライバーの代わりにデータベース用のドライバーを使用することもできます。 ドライバーを使用したデータベースへの接続の詳細については、「既存の接続にユーザードライバーを追加する 」を参照してください。
不足しているドライバーファイルをダウンロード リンクがない場合は、必要なドライバーがすでに存在します。
ホスト、 インスタンス、 ポート フィールドに接続の詳細を指定します。 サーバー名 (たとえば、
DESKTOP) が機能しない場合は、サーバーの IP アドレスに置き換えます。認証 リストから ユーザーとパスワード を選択してください。
ユーザー および パスワード フィールドで、資格情報を指定します。
提供された詳細情報を使用してデータベース接続を確立できることを確認してください。 これを行うには、接続詳細セクションの下部にある 接続のテスト リンクをクリックしてください。
接続の問題が発生した場合は、 データベースに接続できません ページを参照してください。
(オプション) デフォルトでは、デフォルトのデータベースとスキーマのみがイントロスペクトされ、使用可能になります。 他のデータベースやスキーマも操作したい場合は、「スキーマ 」タブで、イントロスペクション用に選択します。
OK をクリックして、データソースを作成します。
データベース ツールウィンドウで新しいデータソースを見つけます。
データベース ツールウィンドウの詳細については、対応する リファレンストピックを参照してください。
JetBrains Rider でのデータベースオブジェクトの操作の詳細については、 データベースオブジェクト を参照してください。
クエリを作成して実行するには、データソースをクリックして F4 を押し、既定の クエリコンソールを開きます。
データベースオブジェクトのデータを表示および編集するには、オブジェクトをダブルクリックして データエディターとビューアー を開きます。
Microsoft SQL Server のシングルサインオンを使用して接続する
Microsoft SQL Server データベースと同じドメインの Windows 上で JetBrains Rider を実行する場合、シングルサインオン (SSO) を利用できます。
データベース ツールウィンドウ () で、 データソースのプロパティ アイコン
をクリックします。 または、 Shift+Enter を押します。データソースおよびドライバー ダイアログで、 追加 アイコン（
）をクリックし、 %microsoft_sql% を選択します。ドライバー リンクをクリックし、 %microsoft_sql% (jTds) を選択します。
接続設定エリアの下部に「不足しているドライバーファイルをダウンロード 」リンクがあるかどうかを確認してください。 このリンクをクリックすると、データベースとのやり取りに必要なドライバーをダウンロードできます。 直接ダウンロードリンクについては、 JetBrains JDBC ドライバーページを参照してください。
ダウンロードされた JDBC ドライバーの場所は JetBrains Rider 構成ディレクトリです。
提供されているドライバーの代わりにデータベース用のドライバーを使用することもできます。 ドライバーを使用したデータベースへの接続の詳細については、「既存の接続にユーザードライバーを追加する 」を参照してください。
不足しているドライバーファイルをダウンロード リンクがない場合は、必要なドライバーがすでに存在します。
ホスト、 インスタンス、 ポート フィールドに接続の詳細を指定します。 サーバー名 (たとえば、
DESKTOP) が機能しない場合は、サーバーの IP アドレスに置き換えます。認証 リストから、 Windows 資格情報 (Windows のみのオプション) を選択します。
提供された詳細情報を使用してデータベース接続を確立できることを確認してください。 これを行うには、接続詳細セクションの下部にある 接続のテスト リンクをクリックしてください。
接続の問題が発生した場合は、 データベースに接続できません ページを参照してください。
(オプション) デフォルトでは、デフォルトのデータベースとスキーマのみがイントロスペクトされ、使用可能になります。 他のデータベースやスキーマも操作したい場合は、「スキーマ 」タブで、イントロスペクション用に選択します。
OK をクリックして、データソースを作成します。
データベース ツールウィンドウで新しいデータソースを見つけます。
データベース ツールウィンドウの詳細については、対応する リファレンストピックを参照してください。
JetBrains Rider でのデータベースオブジェクトの操作の詳細については、 データベースオブジェクト を参照してください。
クエリを作成して実行するには、データソースをクリックして F4 を押し、既定の クエリコンソールを開きます。
データベースオブジェクトのデータを表示および編集するには、オブジェクトをダブルクリックして データエディターとビューアー を開きます。
Windows ドメイン認証を使用して接続する
データベース ツールウィンドウ () で、 データソースのプロパティ アイコン
をクリックします。 または、 Shift+Enter を押します。データソースおよびドライバー ダイアログで、 追加 アイコン（
）をクリックし、 %microsoft_sql% を選択します。ドライバー リンクをクリックし、 %microsoft_sql% (jTds) を選択します。
接続設定エリアの下部に「不足しているドライバーファイルをダウンロード 」リンクがあるかどうかを確認してください。 このリンクをクリックすると、データベースとのやり取りに必要なドライバーをダウンロードできます。 直接ダウンロードリンクについては、 JetBrains JDBC ドライバーページを参照してください。
ダウンロードされた JDBC ドライバーの場所は JetBrains Rider 構成ディレクトリです。
提供されているドライバーの代わりにデータベース用のドライバーを使用することもできます。 ドライバーを使用したデータベースへの接続の詳細については、「既存の接続にユーザードライバーを追加する 」を参照してください。
不足しているドライバーファイルをダウンロード リンクがない場合は、必要なドライバーがすでに存在します。
ホスト、 インスタンス、 ポート フィールドに接続の詳細を指定します。 サーバー名 (たとえば、
DESKTOP) が機能しない場合は、サーバーの IP アドレスに置き換えます。認証 リストから ドメイン資格情報 を選択してください。
ドメイン フィールドで、ドメインを指定します（たとえば、
DEVELOPMENT）。ユーザー および パスワード フィールドで、ドメイン資格情報を指定します。 ユーザー フィールドに、ドメイン接頭辞なしでドメインユーザーを入力します（たとえば、
DOMAIN\John.SmithではなくJohn.Smith）。または、 一般 タブで接続文字列を指定します。 次の完全な接続文字列の例を考えてみます。
jdbc:jtds:sqlserver://DESKTOP:1433;domain=DEVELOPMENT;instance=MSSQLSERVER;databaseName=guest;提供された詳細情報を使用してデータベース接続を確立できることを確認してください。 これを行うには、接続詳細セクションの下部にある 接続のテスト リンクをクリックしてください。
接続の問題が発生した場合は、 データベースに接続できません ページを参照してください。
(オプション) デフォルトでは、デフォルトのデータベースとスキーマのみがイントロスペクトされ、使用可能になります。 他のデータベースやスキーマも操作したい場合は、「スキーマ 」タブで、イントロスペクション用に選択します。
OK をクリックして、データソースを作成します。
データベース ツールウィンドウで新しいデータソースを見つけます。
データベース ツールウィンドウの詳細については、対応する リファレンストピックを参照してください。
JetBrains Rider でのデータベースオブジェクトの操作の詳細については、 データベースオブジェクト を参照してください。
クエリを作成して実行するには、データソースをクリックして F4 を押し、既定の クエリコンソールを開きます。
データベースオブジェクトのデータを表示および編集するには、オブジェクトをダブルクリックして データエディターとビューアー を開きます。
macOS および Linux
SQL Server 認証を使用して接続する
データベース ツールウィンドウ () で、 データソースのプロパティ アイコン
をクリックします。 または、 ⌘ I を押します。データソースおよびドライバー ダイアログで、 追加 アイコン（
）をクリックし、 %microsoft_sql% を選択します。ドライバー リンクをクリックし、 %microsoft_sql% (jTds) を選択します。
接続設定エリアの下部に「不足しているドライバーファイルをダウンロード 」リンクがあるかどうかを確認してください。 このリンクをクリックすると、データベースとのやり取りに必要なドライバーをダウンロードできます。 直接ダウンロードリンクについては、 JetBrains JDBC ドライバーページを参照してください。
ダウンロードされた JDBC ドライバーの場所は JetBrains Rider 構成ディレクトリです。
提供されているドライバーの代わりにデータベース用のドライバーを使用することもできます。 ドライバーを使用したデータベースへの接続の詳細については、「既存の接続にユーザードライバーを追加する 」を参照してください。
不足しているドライバーファイルをダウンロード リンクがない場合は、必要なドライバーがすでに存在します。
ホスト、 インスタンス、 ポート フィールドに接続の詳細を指定します。 サーバー名 (たとえば、
DESKTOP) が機能しない場合は、サーバーの IP アドレスに置き換えます。認証 リストから ユーザーとパスワード を選択してください。
ユーザー および パスワード フィールドで、資格情報を指定します。
提供された詳細情報を使用してデータベース接続を確立できることを確認してください。 これを行うには、接続詳細セクションの下部にある 接続のテスト リンクをクリックしてください。
接続の問題が発生した場合は、 データベースに接続できません ページを参照してください。
(オプション) デフォルトでは、デフォルトのデータベースとスキーマのみがプロジェクトであり、データセットはデータベースであり、スキーマはキースペースであり、名前空間はイントロスペクトされており、使用できます。 他のデータベースとスキーマプロジェクトとデータセット、データベース、スキーマ、共有データベースデータベーススキーマキースペースネームスペースも操作する場合は、「スキーマ 」タブで、イントロスペクションの対象として選択します。
OK をクリックして、データソースを作成します。
データベース ツールウィンドウで新しいデータソースを見つけます。
データベース ツールウィンドウの詳細については、対応する リファレンストピックを参照してください。
JetBrains Rider でのデータベースオブジェクトの操作の詳細については、 データベースオブジェクト を参照してください。
クエリを作成して実行するには、データソースをクリックして F4 を押し、既定の クエリコンソールを開きます。
データベースオブジェクトのデータを表示および編集するには、オブジェクトをダブルクリックして データエディターとビューアー を開きます。
Windows ドメイン認証を使用して接続する
データベース ツールウィンドウ () で、 データソースのプロパティ アイコン
をクリックします。 または、 ⌘ I を押します。データソースおよびドライバー ダイアログで、 追加 アイコン（
）をクリックし、 %microsoft_sql% を選択します。ドライバー リンクをクリックし、 %microsoft_sql% (jTds) を選択します。
接続設定エリアの下部に「不足しているドライバーファイルをダウンロード 」リンクがあるかどうかを確認してください。 このリンクをクリックすると、データベースとのやり取りに必要なドライバーをダウンロードできます。 直接ダウンロードリンクについては、 JetBrains JDBC ドライバーページを参照してください。
ダウンロードされた JDBC ドライバーの場所は JetBrains Rider 構成ディレクトリです。
提供されているドライバーの代わりにデータベース用のドライバーを使用することもできます。 ドライバーを使用したデータベースへの接続の詳細については、「既存の接続にユーザードライバーを追加する 」を参照してください。
不足しているドライバーファイルをダウンロード リンクがない場合は、必要なドライバーがすでに存在します。
ホスト、 インスタンス、 ポート フィールドに接続の詳細を指定します。 サーバー名 (たとえば、
DESKTOP) が機能しない場合は、サーバーの IP アドレスに置き換えます。認証 リストから ドメイン資格情報 を選択してください。
ドメイン フィールドで、ドメインを指定します（たとえば、
DEVELOPMENT）。ユーザー および パスワード フィールドで、ドメイン資格情報を指定します。 ユーザー フィールドに、ドメイン接頭辞なしでドメインユーザーを入力します（たとえば、
DOMAIN\John.SmithではなくJohn.Smith）。または、 一般 タブで接続文字列を指定します。 次の完全な接続文字列の例を考えてみます。
jdbc:jtds:sqlserver://DESKTOP:1433;domain=DEVELOPMENT;instance=MSSQLSERVER;databaseName=guest;提供された詳細情報を使用してデータベース接続を確立できることを確認してください。 これを行うには、接続詳細セクションの下部にある 接続のテスト リンクをクリックしてください。
接続の問題が発生した場合は、 データベースに接続できません ページを参照してください。
(オプション) デフォルトでは、デフォルトのデータベースとスキーマのみがプロジェクトであり、データセットはデータベースであり、スキーマはキースペースであり、名前空間はイントロスペクトされており、使用できます。 他のデータベースとスキーマプロジェクトとデータセット、データベース、スキーマ、共有データベースデータベーススキーマキースペースネームスペースも操作する場合は、「スキーマ 」タブで、イントロスペクションの対象として選択します。
OK をクリックして、データソースを作成します。
データベース ツールウィンドウで新しいデータソースを見つけます。
データベース ツールウィンドウの詳細については、対応する リファレンストピックを参照してください。
JetBrains Rider でのデータベースオブジェクトの操作の詳細については、 データベースオブジェクト を参照してください。
クエリを作成して実行するには、データソースをクリックして F4 を押し、既定の クエリコンソールを開きます。
データベースオブジェクトのデータを表示および編集するには、オブジェクトをダブルクリックして データエディターとビューアー を開きます。
