Skip to main content

Tags

Tags are named references to specific commits, so you can refer to the state of data at a specific point in time using a simple name instead of a commit’s hexadecimal value. For example, you could create a tag Q1FY23 to refer to the version of data that was used for calculating financial reports for the first quarter of the 2023 fiscal year. Tags always point to the same commit.

Viewing Tags​

To view tags in your catalog:

  1. Select the Sonar project that contains your Arctic catalog.
  2. In the left hand side of the Datasets page, click on the name of your Arctic catalog.
  3. On the upper right of your Arctic catalog page, click the History button.
  4. On the top of the page, click the Tags button.

Creating Tags​

You can use the CREATE TAG command to create a tag. For example:

CREATE TAG Q1FY23 AT COMMIT "098a092384fa489283498acdfeffba1411287941"
note

Tag names must be unique in the catalog. Tag names cannot be the same as branch names. To learn more about the CREATE TAG command, visit the SQL Reference.

Querying Tags​

You can query data at a certain tag by referencing it as part of your query. For example:

SELECT * FROM GnarlyCatalog.Sales AT TAG Q1FY23
note

To learn more about querying tags, visit the SQL Reference and API Reference.

Deleting Tags​

You can delete a tag using the DROP TAG command. For example:

DROP TAG Q1FY23
note

To learn more about the DROP TAG command, visit the SQL Reference.