Seems that (at least with MySQL 5.7.23) if you do not set an _id field in the array of items to "add", it fails with error...
[HY000] Document is missing a required field
Adding "_id" => xxxx does resolve the issue.
PHP.mk документација
Collection::add
Почист и полокален преглед на PHP референцата, со задржана структура од PHP.net и подобра читливост за примери, секции и белешки.
Патека
mysql-xdevapi-collection.add.php
Локална патека за оваа страница.
Извор
php.net/manual/en
Оригиналниот HTML се реупотребува и локално се стилизира.
Режим
Прокси + превод во позадина
Кодовите, табелите и белешките остануваат читливи во истиот тек.
Референца
mysql-xdevapi-collection.add.php
Collection::add
Референца за `mysql-xdevapi-collection.add.php` со подобрена типографија и навигација.
Collection::add
(Нема достапни информации за верзијата, можеби е само во Git)
Collection::add — Додај документ во колекција
= NULL
Ја активира вметнувањето на дадениот документ(и) во колекцијата, и се поддржани повеќе варијанти на овој метод. Опциите вклучуваат:
-
Додај еден документ како JSON стринг.
-
Додај еден документ како низа вака:
[ 'field' => 'value', 'field2' => 'value2' ... ] -
Мешавина од двете, и повеќе документи може да се додадат во истата операција.
Параметри
document-
Еден или повеќе документи, и ова може да биде JSON или низа од полиња со нивните поврзани вредности. Ова не може да биде празна низа.
MySQL серверот автоматски генерира уникатни
_idвредности за секој документ (препорачано), иако ова може да се додаде и рачно. Оваа вредност мора да биде уникатна, инаку операцијата за додавање ќе пропадне.
Вратени вредности
Објект CollectionAdd. Користи execute() за да врати Result што може да се користи за прашување на бројот на погодени ставки, бројот на предупредувања генерирани од операцијата, или за преземање список на генерирани ID-а за вметнатите документи.
Примери
Пример #1 mysql_xdevapi\Collection::add() example
<?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");
$collection = $schema->getCollection("people");
// Add two documents
$collection->add('{"name": "Fred", "age": 21, "job": "Construction"}')->execute();
$collection->add('{"name": "Wilma", "age": 23, "job": "Teacher"}')->execute();
// Add two documents using a single JSON object
$result = $collection->add(
'{"name": "Bernie",
"jobs": [{"title":"Cat Herder","Salary":42000}, {"title":"Father","Salary":0}],
"hobbies": ["Sports","Making cupcakes"]}',
'{"name": "Jane",
"jobs": [{"title":"Scientist","Salary":18000}, {"title":"Mother","Salary":0}],
"hobbies": ["Walking","Making pies"]}')->execute();
// Fetch a list of generated ID's from the last add()
$ids = $result->getGeneratedIds();
print_r($ids);
?>Горниот пример ќе прикаже нешто слично на:
Array
(
[0] => 00005b6b53610000000000000056
[1] => 00005b6b53610000000000000057
)
Белешки
Забелешка:
Уникатен _id се генерира од MySQL Server 8.0 или повисок, како што е прикажано во примерот. Полето _id мора рачно да се дефинира ако се користи MySQL Server 5.7.
Белешки од корисници 2 забелешки
cyork на echodreamz точка com ¶
пред 7 години
jcastro на eftec dot cl ¶
пред 7 години
It returns a mysql_xdevapi\CollectionAdd instead of a mysql_xdevapi\Result