Skip to main content

CREATE FOLDER

Create a new folder in your Arctic catalog.

Syntax
CREATE FOLDER [ IF NOT EXISTS ] <folder_name>
  [ AT { REF[ERENCE] | BRANCH } <reference_name> ]

Parameters​

[ IF NOT EXISTS ] Optional

When included, the command runs even if the folder exists and the results indicate that the folder already exists. If this clause is not specified, the command fails if the folder already exists.

<folder_name> String

The name of the folder that you are creating.

AT { REF[ERENCE] | BRANCH } <reference_name> String   Optional

Specifies the reference where you want the new folder to be created. When this parameter is omitted, the current reference is used.

  • REF: Identifies a specific reference.
  • BRANCH: Identifies a specific branch.

Examples​

Create a folder
CREATE FOLDER myFolder
Create a folder if it doesn't exist
CREATE FOLDER IF NOT EXISTS myFolder
Create a folder in the branch called etl_branch
CREATE FOLDER IF NOT EXISTS myCatalog.myFolder
  AT BRANCH etl_branch