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")
}

Edit this page on Github