DeltaCommits

List unbackfilled Delta table commits. WARNING: This API is experimental and may change in future versions.

Changed on

List all the unbackfilled Delta commits that are currently being tracked by the UC coordinator. If no commits are being tracked in the specific version range (from start_version to an optional end_version), it will return an empty list. WARNING: This API is experimental and may change in future versions.

get/delta/preview/commits

Request

  • Base URL
    http://localhost:8080/api/2.1/unity-catalog
  • Auth
    none declared

Request body

table_idstring required

The ID of the table to get the commits for. This ID uniquely identifies a table.

table_uristring required

The URI of the storage location of the table. If the table_id exists but the table_uri is different from the one previously registered (e.g., if the client moved the table), the request will fail. Example: s3://bucket-name/tables/some-table-id

start_versioninteger required

The start version from which to retrieve commits (inclusive). This along with the optional end_version specifies the range of commit versions that this request wants.

end_versioninteger

The end version upto which to retrieve commits (inclusive). If not set, the latest version will be used as the end version. This does not affect the latest_table_version in the response. If num of commits that meet this criteria is larger than a limit set by server config, the response will be limited to the first X commits. Call can send request again with a larger start_version according to the response to get the remaining commits.

Response

Successful response

latest_table_versioninteger required

Represents the latest version of the table tracked by UC. For a newly created managed table with no commits, this returns 0. Use this field to manage pagination — if the returned commits don't cover the range up to latest_table_version or end_version (whichever is smaller), it indicates that more unbackfilled commits may be available.

Changes

    • info

      the response property became required for the status

    • info

      the response property became required for the status

    • warning

      deleted the query request parameter end_version

    • warning

      deleted the query request parameter start_version

    • warning

      deleted the query request parameter table_id

    • warning

      deleted the query request parameter table_uri

    • info

      api tag DeltaCommits added

    • info

      api tag CoordinatedCommits removed

    • info

      added optional request body