CollectionFind::fields

ドキュメントのフィールドのフィルタを設定する

説明

public mysql_xdevapi\CollectionFind mysql_xdevapi\CollectionFind::fields(string $projection)

クエリによって返されるカラムを設定します。設定されない場合は、全てのカラムが使われます。

パラメータ

projection: 単一の文字列か、文字列の配列。検索条件にマッチするドキュメント単位で返されるカラムを識別します。

戻り値

後の処理に使える CollectionFind を返します。

例

例1 mysql_xdevapi\CollectionFind::fields の例

<?php
$session = mysql_xdevapi\getSession("mysqlx://user:password@localhost");

$session->sql("DROP DATABASE IF EXISTS addressbook")->execute();
$session->sql("CREATE DATABASE addressbook")->execute();

$schema = $session->getSchema("addressbook");
$create = $schema->createCollection("people");

$create
  ->add('{"name": "Alfred", "age": 18, "job": "Butler"}')
  ->execute();

// ...

$collection = $schema->getCollection("people");

$result = $collection
  ->find('job like :job and age > :age')
  ->bind(['job' => 'Butler', 'age' => 16])
  ->fields('name')
  ->execute();

var_dump($result->fetchAll());
?>

上の例の出力は、たとえば以下のようになります。

array(1) {
  [0]=>
  array(1) {
    ["name"]=>
    string(6) "Alfred"
  }
}