표기 규칙

표기 규칙 (Notational conventions)

Snowflake 문서에서 문법(syntax)이나 코드를 설명할 때는 꺾쇠 괄호(< >), 대괄호([ ]), 중괄호({ }), 세로 막대(|) 같은 기호가 규칙적인 의미로 사용돼요. 이들이 어떤 뜻인지만 정확히 알아 두면, 복잡한 문법 표기도 쉽게 읽어낼 수 있어요. 다만 이런 기호는 '표기'를 위한 것이지 실제로 입력할 값은 아니라는 점이 핵심이에요.

출처: Snowflake SQL Reference

본문

Snowflake 문서에서는 다음과 같은 표기 규칙을 사용해요.

중요

문법과 코드 설명에서 꺾쇠 괄호(< >), 대괄호([ ]), 중괄호({ }), 세로 막대(|)는 표기 목적으로만 사용돼요. 명령을 입력하거나 코드를 작성할 때는 문법 오류를 피하기 위해 이 기호들을 입력하면 안 돼요.

다만 대괄호와 중괄호는 JSON과 XML에서 특별한 의미를 갖기 때문에, JSON이나 XML 문서·데이터를 다룰 때는 반드시 포함해야 해요.

문법, 예시, 텍스트

표기 설명
ITEM, `ITEM` 전체가 대문자면 Snowflake SQL 명령어, 키워드, 파라미터 이름, 함수 이름을 나타내요.
item, `item` 전체가 소문자면 식별자(identifier), 파라미터, 인자에 대해 사용자가 제공하는 값을 나타내요.
_<item>_, `item` 꺾쇠 괄호와 이탤릭체는 사용자가 제공하는 식별자, 파라미터, 인자를 나타내요.
`( item1 item2 ... )` 괄호는 SQL에서 파라미터나 인자를 묶는 데 사용돼요. 명령을 입력할 때는 반드시 필요해요 (즉, 표시된 그대로 정확히 입력해야 해요).
`{ item1 item2 ... }` 중괄호는 식별자, 파라미터, 인자의 그룹을 나타내요. 선택지가 여러 개일 때 세로 막대와 함께 사용해 선택 범위를 구분하기도 해요. 두 경우 모두 중괄호를 입력하면 안 돼요.
`[ ITEM ]`, `[ item1 item2 ... ]` 대괄호는 문의 생략 가능한(optional) 부분을 나타내요. 입력하면 안 돼요. 대부분의 경우 대괄호 안 항목들은 기본값이 제공되어 생략 가능해요.
`|` 세로 막대는 보통 대괄호나 중괄호 안에서 둘 이상의 항목·값 중 하나를 선택한다는 뜻이에요. 대괄호나 중괄호는 입력하면 안 돼요.
`...` (줄임표) 앞의 항목이 횟수 제한 없이 반복될 수 있음을 나타내요.

예시

다음에서 키워드 WORK는 생략 가능해요.

BEGIN [ WORK ]

따라서 다음 둘 다 유효해요.

BEGIN;
BEGIN WORK;

다음에서는 키워드 WORK 또는 TRANSACTION 중 하나를 사용할 수 있어요. 둘 다 사용하면 안 되고, 둘 다 생략해도 돼요.

BEGIN [ { WORK | TRANSACTION } ]

따라서 다음 모두 유효해요.

BEGIN;
BEGIN WORK;
BEGIN TRANSACTION;

다음은 인자를 하나 받는 함수 호출의 문법이에요. 괄호는 필수예요. <function_name>, <argument_name>, <data_type>은 실제 이름으로 바꿔야 해요.

create function <function_name>( <argument_name> <data_type> )

따라서 다음은 유효해요.

create function my_function(my_argument integer)

다음은 인자를 최소 하나 필요로 하고, 추가 인자는 선택적으로 받는 함수를 나타내요.

<function_name>( <argument_name> <data_type> [ , <argument_name> data_type ] ... )

따라서 다음 모두 유효해요.

my_function(argument_1 integer)
my_function(argument_1 integer, argument_2 integer)
my_function(argument_1 integer, argument_2 integer, argument_3 varchar)

이 경우에도 추가 인자를 더 넣을 수 있어요.

JSON 데이터

표기 설명
`[ item1 ... ]` 대괄호는 JSON 배열 구분자예요.
`{ item1 item2 ... }` 중괄호는 JSON 객체 구분자예요.

XML 데이터

표기 설명
` ... ` 꺾쇠 괄호는 XML 요소의 시작 또는 끝을 나타내요.

더 알아보기 (Learn more)