MCreate #
Creates multiple documents.
Returns a partial error (error code 206) if one or more documents creations fail.
Arguments #
MCreate( index string, collection string, documents json.RawMessage, options types.QueryOptions) (json.RawMessage, error)| Argument | Type | Description |
|---|---|---|
index | string | Index name |
collection | string | Collection name |
documents | json.RawMessage | JSON array of documents to create |
options | types.QueryOptions | A struct containing query options |
options #
Additional query options
| Option | Type (default) | Description |
|---|---|---|
Queuable | bool ( true) | If true, queues the request during downtime, until connected to Kuzzle again |
Refresh | string ( "") | If set to wait_for, waits for the change to be reflected for search (up to 1s) |
Return #
Returns a json.RawMessage containing two arrays, successes and errors.
Each created document is an object of the successes array with the following properties:
| Name | Type | Description |
|---|---|---|
_id | string | Document ID |
_version | int | Version of the document in the persistent data storage |
_source | json.RawMessage | Document content |
Each errored document is an object of the errors array with the following properties:
| Name | Type | Description |
|---|---|---|
document | json.RawMessage | Document that caused the error |
status | int | HTTP error status |
reason | string | Human readable reason |
Usage #
documents := json.RawMessage(`[ { "_id": "some-id", "body": { "capacity": 4 } }, { "body": { "this": "document id is auto-computed" } } ]`) response, err := kuzzle.Document.MCreate( "nyc-open-data", "yellow-taxi", documents, nil) if err != nil { log.Fatal(err) } else { fmt.Println(string(response)) /* { "successes": [ { "_id":"some-id", "_source":{ "_kuzzle_info":{ "active":true, "author":"-1", "updater":null, "updatedAt":null, "deletedAt":null, "createdAt":1538484279484 }, "capacity":4 }, "_index":"nyc-open-data", "_type":"yellow-taxi", "_version":1, "result":"created", "_shards":{ "total":2, "successful":1, "failed":0 }, "created":true, "status":201 }, { "_id":"AWY0zxi_7XvER2v0e9xR", "_source":{ "_kuzzle_info":{ "active":true, "author":"-1", "updater":null, "updatedAt":null, "deletedAt":null, "createdAt":1538484279484 }, "this":"document id is auto-computed" }, "_index":"nyc-open-data", "_type":"yellow-taxi", "_version":1, "result":"created", "_shards":{ "total":2, "successful":1, "failed":0 }, "created":true, "status":201 } ], errors: [] } */ fmt.Println("Success") }