各製品の資料を入手。
詳細はこちら →
製品をチェック
【完全ガイド】Kintone のデータをSQL Server のリンクサーバーで連携する方法
SQL Server からCData ODBC Driver のSQL Gateway 機能を使ってKintone にリンクサーバーとして接続する方法を解説。設定手順からVisual Studio での活用例まで詳細に紹介します。
最終更新日：2025-03-14
この記事で実現できるKintone 連携のシナリオ
こんにちは！ドライバー周りのヘルプドキュメントを担当している兵藤です。
本記事では、SQL ServerのTDS Remoting 機能を使ってKintone にリンクサーバーとしてシームレスに連携する方法を解説します。この連携には、CData ODBC Driverに同梱されているSQL Gateway を使用します。この方法により、SQL Server のインターフェースからKintone への読み書き双方向のアクセスが可能になり、既存のSQL Server 環境で外部データを活用できるようになります。スクリーンショット付きで紹介していくので、初心者の方でも簡単に設定できます！
Kintone をSQL Server のリンクサーバーとして利用する3つの主要シナリオ
- SQL Server に接続しているアプリケーションでKintone のデータを利用したいがデータ接続を増やしたくない
- Kintone のデータをSQL Server のデータや他のリンクサーバーのデータをJOIN などして使いたい
- 利用したいミドルウェア・BI ツールなどにODBC やJDBC の汎用のインターフェースがないが、SQL Server には接続できる
【準備編】Kintone ODBC DSNの設定方法
まずは、本記事右側のサイドバーからKintone ODBC Driver の無償トライアルをダウンロード・インストールしてください。ODBC ドライバーのインストール完了時にODBC DSN 設定画面が立ち上がります。または、Microsoft ODBC データソースアドミニストレーターを使ってDSN を作成および設定できます。
Kintone 接続プロパティの設定方法
Kintone に接続するには、以下の接続プロパティを設定する必要があります。
- URL：Kintone のアクセスURL（例：https://yoursitename.cybozu.com または https://yoursitename.kintone.com）
- User：アカウントのユーザー名
- Password：アカウントのパスワード
- AuthScheme：Password を指定
パスワード認証の代わりにAPI トークン認証を利用する場合は、ヘルプドキュメントの「接続の設定」セクションをご参照ください。
Basic 認証の設定
ご利用のKintone ドメインでBasic 認証を有効にしている場合は、接続プロパティの「詳細」設定で以下の項目を追加設定してください。
- BasicAuthUser：Basic認証のユーザー名
- BasicAuthPassword：Basic認証のパスワード
クライアント証明書認証の設定
Basic認証の代わりにクライアント証明書による認証を利用する場合は、以下の項目を設定してください。
- SSLClientCert：クライアント証明書のパス
- SSLClientCertType：証明書の種類
- SSLClientCertSubject：証明書のサブジェクト
- SSLClientCertPassword：証明書のパスワード
【設定手順1】SQL Gateway でKintone ODBC DSN をセットアップする方法
CData ODBC ドライバにはSQL Gateway が同梱されています。このSQL Gateway に、Kintone ODBC Driver をサービスとして設定します。
- 「スタート」画面から「SQL Gateway」を起動します。青い「C」のSQL Gateway ロゴが右下のインジケータに表示されます。 アプリケーションコンソールが開かない場合には、SQL Gateway アイコンを右クリックして、「Open Application」をクリックしてください。
- アプリケーションコンソールの「Service」タブを開いて、「Add」をクリックして、新しいODBC データソースを設定します。
-
Kintone ODBC の設定を行います。
Service Name]:任意
リモーティングDB 選択:SQL Server を選択
Data Source:ドロップダウンでCData Kintone Source Sys を選択
Port:使用していないポートを選択
-
次に「Users」タブ→「Add」からユーザーを登録します。
ユーザー毎にFull アクセスか、Readonly か、None の権限を選択できます。
複数のODBC データソースがある場合には、データソース毎に権限の設定が可能です。
「OK」を押して、ユーザー登録を完了します。 その後「Save Changes」で設定を保存します。 - SQL Gateway の「Service」タブで「Start」ボタンを押して、サービスを起動します。サービスの左側の〇が緑色になれば、サービスは起動中です。
【設定手順2】SQL Server でKintone リンクサーバーを構築する方法
SQL Gateway 側でサービスの設定が終わったら、SQL Server 側でKintone サービスをリンクサーバーとして使う設定をしましょう。
-
SQL Server Management Studio (SSMS) を開きます。
オブジェクトエクスプローラーの「サーバーオブジェクト」で「リンクサーバー」を右クリックして、「新しいリンクサーバー」をクリックします。 -
新しいリンクサーバーの設定画面の「全般」で、以下を入力します。
サーバー種類：その他データソース
プロバイダー：SQL Server Native _Client 11.0
データソース：この例の場合、localhost, 1433 を入力
カタログ：ODBC DSN 名を入力
- また、「セキュリティ」では、「このセキュリティコンテキスト」を選択して、リモートログインにSQL Gateway にユーザー設定したUser 名とPassword を入力します。
これで、リンクサーバーの設定は終わりなので、「OK」を押して設定を保存します。
【活用例1】SSMS（SQL Server Management Studio）でKintone データを操作する方法
SSMS のオブジェクトエクスプローラーのリンクサーバー下にKintone のリンクサーバーが作成され、「テーブル」下にKintone のデータがアプリ単位でテーブルが生成されます。
新しいクエリを選択し、Kintone のデータを取得してみます。
実践的なSQL クエリの例と解説
SELECT * from リンクサーバー名.CData Kintone Source Sys（ODBC DSN 名）.Kintone.テーブル名
このように、API のリクエストではなく通常のSQL 構文でデータを扱うことが可能になっています
【活用例2】Visual Studio からKintone のリンクサーバーに連携する方法
Visual Studio のサーバーエクスプローラーの「データ接続」を右クリックし、「接続の追加」をクリックして、データソースの選択画面を開きます。 データソースの選択画面でデータソースを「Microsoft SQL Server 」に選択して、「続行」を押します。
Visual Studio での接続設定とクエリ実行手順
「接続の追加」画面で、以下を入力します。
サーバー名:SQL Server のサーバー名
認証:任意の認証方式
データベース名の選択または入力:※master など
※リンクサーバーを直接データベース名として入力することはできないようです。なので上位のデータベース名で設定しておきます。
「テスト接続」をして大丈夫であれば、「OK」を押して設定を完了させます。
「新しいクエリ」で、SQL でSELECT 文を書いてデータを取得してみます。
SELECT * from リンクサーバー名.CData Kintone Source Sys（ODBC DSN 名）.Kintone.テーブル名
このように、通常のSQL Server のリンクサーバーと同じようにVisual Studio 内Kintone のデータを扱うことが可能になります。
他のIDE でもSQL Server にアクセスする方法でKintone のデータにSQL でアクセスが可能になります。
複数データソースのJOIN などを行う場合には大変便利です。
【応用編】Kintone データとSQL Server データを組み合わせた高度な活用例
リンクサーバーの真価は、異なるデータソースを組み合わせた分析や処理にあります。以下に実践的な活用例をご紹介します。
複数データソースの結合（JOIN）によるデータ統合
SELECT
s.customer_id,
s.customer_name,
o.order_id,
o.order_date,
o.total_amount
FROM
Sales.Customers s
JOIN
リンクサーバー名.CData Kintone Source Sys.Kintone.Orders o
ON
s.customer_id = o.customer_id
WHERE
o.order_date > '2023-01-01'
ORDER BY
o.total_amount DESC
このクエリ例では、SQL Server内の顧客データとKintone 内の注文データを顧客IDで結合し、2023年以降の注文を金額順に表示しています。
おわりに
このようにCData ODBC ドライバと併用することで、Kintone を含む270を超えるSaaS、NoSQL データをSQL Server に連携できます。30日の無償評価版が利用できますので、ぜひ自社で使っているクラウドサービ スやNoSQL と合わせて活用してみてください。
CData で実現できるkintone 連携のユースケース
関連コンテンツ
