LINQPad でCouchDB のデータを操作する方法

LINQPad でCouchDB にLINQ クエリを実行する方法を解説します。

加藤龍彦
デジタルマーケティング
最終更新日：2023-09-15

この記事で実現できるCouchDB 連携のシナリオ

CData

こんにちは！ウェブ担当の加藤です。マーケ関連のデータ分析や整備もやっています。

CData ADO.NET Provider for ApacheCouchDB は、LINQ やEntity Framework などの標準のADO.NET インターフェースを使ってCouchDB の操作を実現します。この記事では、LINQPad から接続してLINQ クエリを実行する方法を説明します。

必要なもの

本記事の手順を実行してLINQPad からCouchDB に接続するには、以下の3つの製品が必要になります。

CouchDB の環境
LINQPad
CData ADO.NET Provider for ApacheCouchDB。右側のサイドバーから30日間無償トライアルがダウンロードできます

データモデルの作成

CData ADO.NET Provider for ApacheCouchDB およびLINQPad をダウンロード・インストールしたら、Visual Studio で新しいクラスライブラリプロジェクトを作成します。

ADO.NET Provider の利用に必要となるEF 6を設定する方法については、ヘルプドキュメントを参照してください。

プロジェクトを右クリックし、［追加］→［新しい項目］→［ADO.NET Entity Data Model］をクリックします。ダイアログが表示されたら、データベースから［Code First］を選択します。［New Connection］をクリックして、表示されたウィザードで接続文字列オプションを指定します。

Apache CouchDB 接続プロパティの取得・設定方法

Url 接続プロパティをApache CouchDB インスタンスのURL に設定します。例：http://localhost:5984

ユーザー（またはJWT）が特定のデータベースだけにアクセスできるようにしたい場合は、Apache CouchDB インスタンスで"admin_only_all_dbs" オプションを設定し、テーブルをリストするために本製品が必要とする"/_all_dbs" エンドポイントへのアクセス権をすべてのユーザーに付与する必要があります。

Apache CouchDB への認証

Basic：基本的なユーザー名 / パスワード認証。
JWT：JWT 認証。
None：パブリックなデータベースへの匿名アクセス。

Basic 認証

データに接続するには以下を設定します。

AuthScheme：Basic。
User：認証に使用されるApache CouchDB ユーザーアカウント。
Password：認証するユーザーに関連付けられたApache CouchDB パスワード。

その他の認証方法は、ヘルプドキュメントの「接続の確立」セクションを参照してください。

一般的な接続文字列は次のとおりです。

Url=http://localhost:5984;User=abc123;Password=abcdef;

希望するテーブルおよびビューを選択して［Finish］をクリックし、データモデルを作成します。
プロジェクトをビルドします。生成されたファイルを使ってLINQPad でCouchDB 接続を作成できます。

LINQPad でCouchDB のデータに接続

必要な接続プロパティを取得してデータモデルアセンブリを作成したら、以下の手順に従ってLINQPad でデータモデルを使いはじめましょう。

LINQPad を開き［接続の追加］をクリックします。
［Use a typed data context from your own assembly］オプションを選択します。
［Entity Framework DbContext］を選択します。
［Path to Custom Assembly］ボックスの横にある［参照］をクリックして、プロジェクトフォルダを参照します。bin フォルダの下の.dll または.exe を参照します。
DbContext の名前を選択します。
接続文字列をApp.Config に保存した場合は、App.Config へのパスを指定します。