LAlance-format
Table
Metadata

Atomically create versions for multiple tables

Changed on

Atomically create new version entries for multiple tables.

This operation is atomic: either all table versions are created successfully, or none are created. If any version creation fails (e.g., due to conflict), the entire batch operation fails.

Each entry in the request specifies the table identifier and version details. This supports put_if_not_exists semantics for each version entry.

post/v1/table/version/batch-create

Request

  • Base URL
    http://localhost:2333
  • Auth
    • OAuth 2
      Client credentials
      Token URL: /oauth/token
    • or HTTP bearer
    • or API key in header x-api-key

Query parameters

delimiterstring

An optional delimiter of the string identifier, following the Lance Namespace spec. When not specified, the $ delimiter must be used.

Request body

contextunknown

Example request

{
  "entries": [
    {
      "naming_scheme": "V2",
      "metadata": {
        "key": "metadata"
      },
      "manifest_path": "manifest_path",
      "manifest_size": 0,
      "id": [
        "id",
        "id"
      ],
      "e_tag": "e_tag",
      "version": 0,
      "branch": "branch"
    },
    {
      "naming_scheme": "V2",
      "metadata": {
        "key": "metadata"
      },
      "manifest_path": "manifest_path",
      "manifest_size": 0,
      "id": [
        "id",
        "id"
      ],
      "e_tag": "e_tag",
      "version": 0,
      "branch": "branch"
    }
  ],
  "identity": {
    "api_key": "api_key",
    "auth_token": "auth_token"
  },
  "context": {
    "key": "context"
  }
}

Response

Result of atomically creating table versions

contextunknown
transaction_idstring

Optional transaction identifier

Example response

{
  "transaction_id": "transaction_id",
  "versions": [
    {
      "metadata": {
        "key": "metadata"
      },
      "manifest_path": "manifest_path",
      "timestamp_millis": 1,
      "manifest_size": 0,
      "e_tag": "e_tag",
      "version": 0
    },
    {
      "metadata": {
        "key": "metadata"
      },
      "manifest_path": "manifest_path",
      "timestamp_millis": 1,
      "manifest_size": 0,
      "e_tag": "e_tag",
      "version": 0
    }
  ],
  "context": {
    "key": "context"
  }
}

Changes

  • 591cd95574b0Revision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

  • 9932582b6bd7Revision changes
    • info

      added the new optional request property //