Creating Views

The JSON definition for creating of a view is implementation dependant and varies for each supported view type. Please refer to the proper section of the required view type for details.

However, in general the format is the following:

Create an ArangoDB view

creates an ArangoDB view

POST /_api/view#arangosearch

A JSON object with these properties is required:

  • type: The type of the view. must be equal to one of the supported ArangoDB view types.
  • name: The name of the view.
  • properties:
    • consolidationIntervalMsec: Wait at least this many milliseconds between committing view data store changes and making documents visible to queries (default: 60000, to disable use: 0). For the case where there are a lot of inserts/updates, a lower value, until commit, will cause the index not to account for them and memory usage would continue to grow. For the case where there are a few inserts/updates, a higher value will impact performance and waste disk space for each commit call without any added benefits. Background: For data retrieval ArangoSearch views follow the concept of "eventually-consistent", i.e. eventually all the data in ArangoDB will be matched by corresponding query expressions. The concept of ArangoSearch view "commit" operation is introduced to control the upper-bound on the time until document addition/removals are actually reflected by corresponding query expressions. Once a "commit" operation is complete all documents added/removed prior to the start of the "commit" operation will be reflected by queries invoked in subsequent ArangoDB transactions, in-progress ArangoDB transactions will still continue to return a repeatable-read state.
    • links:
      • [collection-name]:
        • analyzers (string): The list of analyzers to be used for indexing of string values (default: ["identity"]).
        • fields:
          • field-name (object): This is a recursive structure for the specific attribute path, potentially containing any of the following attributes: analyzers, includeAllFields, trackListPositions, storeValues Any attributes not specified are inherited from the parent.
        • includeAllFields: The flag determines whether or not to index all fields on a particular level of depth (default: false).
        • trackListPositions: The flag determines whether or not values in a lists should be treated separate (default: false).
        • storeValues: How should the view track the attribute values, this setting allows for additional value retrieval optimizations, one of:
      • none: Do not store values by the view
      • id: Store only information about value presence, to allow use of the EXISTS() function (default "none").
    • consolidationPolicy:
    • cleanupIntervalStep: Wait at least this many commits between removing unused files in the ArangoSearch data directory (default: 10, to disable use: 0). For the case where the consolidation policies merge segments often (i.e. a lot of commit+consolidate), a lower value will cause a lot of disk space to be wasted. For the case where the consolidation policies rarely merge segments (i.e. few inserts/deletes), a higher value will impact performance without any added benefits. Background: With every "commit" or "consolidate" operation a new state of the view internal data-structures is created on disk. Old states/snapshots are released once there are no longer any users remaining. However, the files for the released states/snapshots are left on disk, and only removed by "cleanup" operation.

Creates a new view with a given name and properties if it does not already exist.

Note: view can't be created with the links. Please use PUT/PATCH for links management.

Return Codes

  • 400: If the view-name is missing, then a HTTP 400 is returned.

  • 404: If the view-name is unknown, then a HTTP 404 is returned.


shell> curl -X POST --header 'accept: application/json' --data-binary @- --dump - http://localhost:8529/_api/view <<EOF
  "name" : "testViewBasics", 
  "type" : "arangosearch" 

HTTP/1.1 Created
content-type: application/json; charset=utf-8
x-content-type-options: nosniff

Show response body