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.
To view tags in your catalog:
- Select the Sonar project that contains your Arctic catalog.
- In the left hand side of the Datasets page, click on the name of your Arctic catalog.
- On the upper right of your Arctic catalog page, click the History button.
- On the top of the page, click the Tags button.
You can use the
CREATE TAG command to create a tag. For example:
CREATE TAG Q1FY23 AT COMMIT "098a092384fa489283498acdfeffba1411287941"
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.
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
You can delete a tag using the
DROP TAG command. For example:
DROP TAG Q1FY23
To learn more about the
DROP TAG command, visit the SQL Reference.