표기법¶
Snowflake 설명서에는 다음 표기법이 사용됩니다.
중요
구문 및 코드 설명에서 꺾쇠 괄호(< >
), 대괄호([ ]
), 중괄호({ }
), 세로 막대(|
)는 표기 목적으로만 사용됩니다. 구문 오류를 방지하려면 명령을 입력하거나 코드를 작성할 때 구문 오류를 포함하지 마십시오.
하지만 대괄호와 중괄호는 JSON 및 XML에서 특정한 의미를 가지므로, JSON 또는 XML 문서/데이터로 작업할 때 이들을 포함해야 합니다.
구문, 예, 텍스트¶
표기법 |
설명 |
---|---|
ITEM , |
모두 대문자는 Snowflake SQL 명령, 키워드, 매개 변수 이름 또는 함수 이름을 나타냅니다. |
항목, |
모두 소문자는 식별자, 매개 변수 또는 인자에 대해 사용자가 제공한 값을 나타냅니다. |
<항목> , |
꺾쇠 괄호와 기울임꼴은 사용자가 제공하는 식별자, 매개 변수 또는 인자를 나타냅니다. |
|
괄호는 SQL에서 매개 변수 또는 인자를 그룹화하는 데 사용됩니다. 명령을 입력할 때는 괄호가 필수적 입니다(즉, 괄호는 나타나는 대로 정확하게 입력해야 함). |
|
중괄호는 식별자, 매개 변수 또는 인자의 그룹화를 나타냅니다. 또한, 둘 이상의 항목을 선택할 수 있을 때 선택 항목을 구분하기 위해 중괄호를 세로 막대와 함께 사용하기도 합니다. 두 경우 모두, 중괄호를 입력하면 안 됩니다. |
|
대괄호는 문의 선택적 부분을 나타냅니다. 대괄호를 입력하면 안 됩니다. 많은 경우, 기본값이 제공되므로 대괄호 안의 항목은 선택 사항입니다. |
|
세로 막대는 일반적으로 대괄호 또는 중괄호 내에서 둘 이상의 항목이나 값 중에서 선택한다는 뜻입니다. 대괄호나 중괄호는 입력하면 안 됩니다. |
|
이전 항목은 무한히 반복될 수 있습니다. |
예¶
다음에서 키워드 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 데이터¶
표기법 |
설명 |
---|---|
|
대괄호는 JSON 배열 구분 기호입니다. |
|
중괄호는 JSON 오브젝트 구분 기호입니다. |
XML 데이터¶
표기법 |
설명 |
---|---|
|
꺾쇠 괄호는 XML 요소의 시작 또는 끝을 나타냅니다. |