♎️ 👩🏿‍🎓 ☂️ PHPと組み合わせたCouchbaseの例 👙 👩🏻‍🎤 🎞️

免責事項

この記事では、過去の経験やプロジェクトの開発中に遭遇した浅瀬に関係なく、慣れ親しんだものをすべて終了してCouchbaseの使用に切り替えることをお勧めしません。この記事は、Couchbase ServerをPHPなどと組み合わせて使用する技術の簡単な説明にすぎません。おそらく、それは可能性の説明として、またおそらく見通しに対する評価の観点としても興味深いでしょう。

それは何で、何を食べますか

Couchbaseは、Couchbase、Incによって開発されたNoSQLデータベースの次のラインであり、親であるCouchDBの伝統と問題の直接の子孫です。これはドキュメント指向のデータベースであり、個々のレコードをドキュメントとして保存することを意味しますが、これは厳密なルールではなく、値（BLOB行まで）はレコードとして機能しますが、この（および他のデータベースも）の魅力はドキュメントベースのデータ保存方法。

ドキュメントベースのデータ保存方法は、すべてのデータがいわゆるドキュメントの形式で保存されることを意味します。レコードに存在する常識と一般的な論理の原則に関する文書にまとめられたフィールドのセット。このようなレコードの例としては、たとえば、ログイン、パスワード、電子メールなどのフィールドのリストを持つユーザープロファイルがあります。この場合、ドキュメントストレージの標準はJSON文字列形式のドキュメント形式です。この形式は、非常に人気があり、簡単に解釈でき、人間が読める形式であるため、作成者が慎重に選択しました。しかし、ポイントではありません。文書とは何か、データベース内でどのように見えるかを把握しておくことが重要です。

仕事に必要なコンポーネント

PHPを使用してCouchbaseを操作するには、いくつかのソフトウェアが必要です。

これらすべてを正常にインストールして正常に起動した後、Couchbaseと呼ばれるクラスを使用する機会があります。この説明はCouchbaseの公式Gitリポジトリにあります。さらに使いやすくするために、お気に入りのIDeが自動設定を正常に獲得できるように、プロジェクトに追加することをお勧めします。

さらに、便利な作業のために、Couchbase自体に個別のバケット（データベースのアナログ）を作成する必要があります。これにより、一般的なデフォルトを損なう必要がなくなります。これは、 localhostアドレス8091 / index.html＃sec = bucketsに移動し、「Create new bucket」ボタンをクリックして行います。

コーディングを開始

抽象的なものをコーディングするのは理にかなっていないので、上記の非常に具体的な例、つまりユーザープロファイルを見てみましょう。ユーザーがいくつかのフィールドを持っているとしましょう：ログイン、パスワード、電子メール、暗黙のうちに-これは整数型の識別子です。 JSON表現では、結果のドキュメントは次のようになります。

{ "login": "megausername", "password": "my secured password!", "email": "email@example.com" }

まず、このビジネスをデータベースに保存する方法と、そこからデータを取得する方法を見つける必要があります。これは非常に簡単に行われ、次の例ではっきりとわかります。

 <?php /** *         Couchabse     ,   * .       ,     ,   * Couchbase      ,       master-master   *   ,    Couchbase Server.  ,      Bucket  *   ,    ,    ,        *      . */ $couchbase = new Couchbase(array('localhost'), 'couchbase_user', 'couchbase_password', 'users_bucket', TRUE); /** *          PHP */ $document = array( 'login' => 'megausername', 'password' => 'my secured password!', 'email' => 'email@example.com' ); /** *        .     ID ,  *  Couchbase   , ..        * autoincrement .                * . ,    ,    . */ $userId = $couchbase->increment('counter::users', 1, TRUE); /** *           .      * .  -    add,        ,   , *   ,  .   - set,        , *       ,    .   -  ,     *         add */ try { $couchbase->add("profile::{$userId}", json_encode($document)); } catch(\CouchbaseException $e) //    ,   Exception    { //          ,       . error_log("    Couchbase: {$e->getMessage()}"); exit(1); } /** *             .      get. *      ,   ,       ,  JSON , *           . */ try { $userData = json_decode($couchbase->get("profile::{$userId}")); } catch(\CouchbaseException $e) //    ,   Exception    { //          ,       . error_log("   Couchbase: {$e->getMessage()}"); exit(1); }

ご覧のとおり、上記の例では、ユーザーIDの生成を除いて、まったく問題はありません。困難は、検索を開始する必要がある直後に始まります。

ビューとは何ですか？

Couchbaseサーバーのコントロールパネルにアクセスすると、Viewsという素晴らしいものに気付くでしょう。「開発ビュー」と「生産ビュー」という2つのサブアイテムがあります。ディスプレイを推測することは難しくありません（Couchbaseのコンテキストでは、選択です）。空がありますが、そこを台無しにする方法を見つけます。

ビューは基本的にインデックスであり、JavaScriptで記述できる作成のルールです。はい、はい。ここでのインデックスは、ユーザーが記述したロジックに基づいて作成され、列挙関数だけでなく、いくつかのセマンティック関数も保持します。たとえば、電子メールがn文字より長いユーザーをインデックスに含めることも、特定のフィールドのみを表示することもできます。インデックスを操作するには、JavaScriptしかありませんが、それで十分です。インデックスは、オンデマンド（データの要求時）で更新されるか、データベースの断片化が特定の割合（バケット設定で指定）に達すると自動的に更新されます。この点も開発時に考慮する必要があります。

ビューを作成するには2つの方法があります。 1つ目は、開発セクションのコントロールパネルにJavaScriptルールを直接記述してプロダクションに転送するか、PHPから直接プロダクションセクションに移動するスクリプトの説明を使用してsetDesignDocメソッドをプルすることです。

最初に、スクリプトとその構成要素を検討します。スクリプトは、ドキュメントとそのコンテンツのメタ情報の説明が入力される関数です。ユーザーのログインに基づいてインデックスを作成してみましょう。

 function (doc, meta) { //     JSON      login if (meta.type == "json" && doc.login) { //      userId (      ) var userid = meta.id.split("::"); //       / emit(doc.login, parseInt(userid[1])); } }

上記のJavaScriptメソッドのおかげで、インデックス（emitメソッドを使用して生成される）にはログインフィールドを持つエントリのみが含まれることを理解できます。ご覧のとおり、JavaScript関数はコールバック関数の形式で作成され、このバケットにある各レコードに適用されます。ビューは、バケットライフサイクルの存在中いつでも作成できることに注意してください。つまり新しい機能を追加する必要がある場合は、新しいビューを簡単に追加して、必要に応じてそのまま使用できます。

など。彼のログインしかわからない場合に、ユーザーIDを見つける方法を理解します。これを行うには、新しいインデックスを作成し（PHPコードからすぐに作成します）、それを呼び出す必要があります。

 /** *    view */ $designedDocument = array( 'language' => 'javascript', 'views' =>array( 'login' => array( 'map' => 'function (doc, meta) {if (meta.type == "json" && doc.login) {var userid = meta.id.split("::"); emit(doc.login, parseInt(userid[1]));}}' ) ), ); /** *         */ $couchbase->setDesignDoc('userFields', json_encode($designedDocument));

このコードを実行した直後にCouchbaseコントロールパネルに移動すると、（大容量で）インデックスの作成の進行状況が右上に表示されます。完了したら、コントロールパネルで開いて[結果を表示]ボタンをクリックして、動作を確認できます。答えでは、JavaScriptコールバックメソッドによって生成されたキーと値のペアが表示されます。

PHPコードから、次のクエリで選択を取得できます。

 //      JSON ,      $result = $couchbase->view('userFields', "login");

答えは2つの要素の配列です：total_rows-このインデックスのレコードの合計数が含まれる場所とrowsフィールド-サンプルからの配列の配列が存在する場所：array（ 'id' => 'profile :: 0'、 'key '=>' megausername '、' value '=> 0）。このフィールドの配列内：_idは、選択に該当したドキュメントの識別子です。キーはインデックスの形成中に指定されたキーであり、値は生成した値です。

ただし、この方法でインデックス全体を取得するという事実を考慮する必要がありますが、これは検索にはあまり適していません。そして、識別子のみを見つける必要がある場合はどうでしょうか？インデックス全体を手動で反復しないでください。もちろん違います。このため、表示する各リクエスト中に、追加のパラメーターを指定できます。たとえば、ログインで指定されたユーザーの識別子のみを知りたい場合、表示するリクエストで特定のキーを指定する必要があります。これは次のように行われます。

 $result = $couchbase->view('userFields', "login", array('key'=>'megausername'));

これは、結果として、「megausername」に等しいキーを持つレコードのみを持つ幸せな瞬間です。一緒に仕事をして幸せになれます。落とし穴は1つだけです。上記のように、指定されたバケットにレコードを追加または変更するときではなく、バケットの断片化の特定の割合に達したときにのみ、インデックスが再構築されます。

操作を実行する前に、ユーザー名の一意性を確認する必要があるとします。たとえば、ユーザーを登録するとき。当然、このビューの要求を満たし、データベースの応答を分析します。ただし、同じ名前のユーザーが登録されたばかりで、インデックスを再構築する時間がまだない可能性があります。当然、インデックスにそのようなレコードが存在しないという情報が届き、競合が発生します。このような状況を回避するために、ビューインデックスを呼び出すときに、インデックスを再構築する必要性を彼に示すことができます。つまりこのインデックスで実行されなかったすべての操作が最初に完了し、その後クエリが完了して結果が返されます。これを行うには、値がFALSEの古いオプションを追加します。これは次のように行われます。

 $result = $couchbase->view('userFields', "login", array('key'=>'megausername', 'stale'=>FALSE));

このリクエストの結果、インデックスの操作に関連するすべての操作が完了し、データベースにある実際の結果が得られます。このような特定のデータを扱うときは、この点を考慮することが重要です。

おわりに

ご覧のとおり、Couchbase Serverでの作業はそれほど難しくありません。作業を開始する前にドキュメントを徹底的に研究し、行動を考えて分析することを忘れないことが重要です。誰もがCouchbaseに切り替えるように動揺することはありませんが、個人的には、新しいフィールドを追加するときに構造を根本的に変更することなくデータベースを操作できることは、上記のシステムの開発において非常に「おいしい」要素でした。しかし、厳しい現実はすべてをその場所に戻します。私の特定のケースでは、個々のフィールドの統計をリアルタイムで生成し、MSSQLエンジンで実行されている統計の保存/分析システムと対話することに関して疑問が生じました。この事実は、DBA開発者の便利な作業のための「クランチ」の編成につながり、その結果、SQL形式のフィールド管理システムの重複が生じました。プロジェクトでNoSQLデータベースエンジンを使用する場合は、内部インフラストラクチャに関連付けられていないスタンドアロンプロジェクトから開始することをお勧めします。簡単に統合することはできません。

ご質問がある場合は、 www.couchbase.com / documentationにあるドキュメントをご覧になることをお勧めします。

このトピックに引き続き興味がある場合は、少し複雑なレベルで明らかにすることができます。以下の記事に記載されている、SQLの考え方からNoSQLに移行する方法を検討してください。 CouchbaseでGROUP BY、ORDER、その他の興味深いことを整理する方法を検討し、ドキュメント指向データベースの最適化と設計の問題をより深く検討します。

PHPと組み合わせたCouchbaseの例