Version Control#

Version control is one of the important features of Graviti. It can help teams or individual users develop datasets in parallel and trace the history of the data.

HEAD#

SDK supports viewing the version of the dataset through property HEAD:

>>> from graviti import Workspace
>>> ws = Workspace(f"{YOUR_ACCESSKEY}")
>>> dataset = ws.datasets.get("Graviti-dataset-demo")
>>> dataset.HEAD
Branch("main")(
  (commit_id): '47293b32f28c4008bc0f25b847b97d6f',
  (parent): None,
  (title): 'Commit-1',
  (committer): 'graviti-example',
  (committed_at): 2022-07-20 04:23:45+00:00
)
>>> dataset.HEAD.name
"main"
>>> dataset.HEAD.commit_id
"47293b32f28c4008bc0f25b847b97d6f"

Checkout#

SDK provides method checkout() to support switching the version of the dataset. This method will modify the HEAD of the dataset and discard the previous modification on the dataset.

Checkout the Branch("dev"):

>>> from graviti import Workspace
>>> ws = Workspace(f"{YOUR_ACCESSKEY}")
>>> dataset = ws.datasets.get("Graviti-dataset-demo")
>>> dataset.HEAD
Branch("main")(
  (commit_id): '47293b32f28c4008bc0f25b847b97d6f',
  (parent): None,
  (title): 'Commit-1',
  (committer): 'graviti-example',
  (committed_at): 2022-07-20 04:23:45+00:00
)
>>> dataset.checkout("dev")
Branch("dev")(
  (commit_id): '781007a41d1641859c87cb00f8e32bf3',
  (parent): Commit("3db73ac2876a42c0bf43a0489ce1756a"),
  (title): 'commit-5',
  (committer): 'graviti-example',
  (committed_at): 2022-07-19 04:23:45+00:00
)

Checkout the Tag("v1.0"):

>>> dataset.checkout("v1.0")
Tag("v1.0")(
  (commit_id): '2cd44960e0bf486c950536f7eeebc482',
  (parent): Commit("e8dc893eb2344b9a98bddce71a1c0eab"),
  (title): 'commit-7',
  (committer): 'graviti-example',
  (committed_at): 2022-07-19 04:25:45+00:00
)

Checkout the Commit("2cd4496"):

>>> dataset.checkout("2cd44960e0bf486c950536f7eeebc482")
Commit("2cd44960e0bf486c950536f7eeebc482")(
  (parent): Commit("e8dc893eb2344b9a98bddce71a1c0eab"),
  (title): 'commit-7',
  (committer): 'graviti-example',
  (committed_at): 2022-07-19 04:25:45+00:00
)

More Details#

More details about the version control methods are as follows: