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. The name cannot include the following special characters: /, :, [, or ].

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