JavaScript 저장 프로시저 API

이 항목에서는 Snowflake 저장 프로시저를 위한 JavaScript API를 다룹니다. API는 JavaScript 오브젝트와 그러한 오브젝트의 메서드로 구성됩니다.

이 항목의 내용:

오브젝트: snowflake

snowflake 오브젝트는 기본적으로 저장 프로시저의 JavaScript 코드에 액세스할 수 있으며, 이 오브젝트를 만들 필요가 없습니다. 이 오브젝트는 저장 프로시저 API에 메서드를 포함합니다. 예:

create procedure stproc1()
  returns string not null
  language javascript
  as
  -- "$$" is the delimiter for the beginning and end of the stored procedure.
  $$
  // The "snowflake" object is provided automatically in each stored procedure.
  // You don't need to create it.
  //         |||||||||
  //         vvvvvvvvv
  var statement = snowflake.createStatement(...);
  ...
  $$
  ;
Copy

저장 프로시저 작업하기 에 더 광범위한 코드 예가 제공됩니다.

상수

없습니다.

메서드

addEvent(name[, attributes])

추적을 위한 이벤트를 추가합니다.

JavaScript에서 추적 이벤트에 대한 자세한 내용은 JavaScript에서 추적 이벤트 내보내기 섹션을 참조하십시오.

매개 변수

name

추가할 이벤트의 이름입니다.

attributes

이벤트와 연결할 특성을 지정하는 오브젝트입니다.

오류

다음과 같은 경우 JavaScript 오류를 발생시킵니다.

  • name 은 문자열이 아닙니다.

  • 0개 또는 3개 이상의 인자가 있습니다.

예

score 및 pass 특성이 있는 my_event 이벤트를 추가합니다.

snowflake.addEvent('my_event', {'score': 89, 'pass': true});
Copy
createStatement(sql_command_object)

Statement 오브젝트를 만들고 반환합니다. 오브젝트의 execute() 메서드는 나중에 실행할 수 있습니다.

매개 변수

sql_command_object

이 입력 매개 변수는 실행할 문의 텍스트와 해당 문에 바인딩해야 하는 값을 포함하는 JSON 오브젝트(사전)입니다.

반환

Statement 오브젝트입니다.

오류

다음과 같은 경우 JavaScript 오류를 발생시킵니다.

  • sqlText 가 없거나 빈 쿼리 텍스트를 포함하는 경우.

  • 이 문은 지원되지 않는 데이터 타입을 가진 인자를 바인딩하려고 하는 경우. 데이터 타입 매핑에 대한 자세한 내용은 SQL 및 JavaScript 데이터 타입 매핑 을 참조하십시오. 바인딩에 대한 자세한 내용은 변수 바인딩하기 를 참조하십시오.

예

다음 예에서는 어떤 값도 바인딩하지 않습니다.

var stmt = snowflake.createStatement(
   {sqlText: "INSERT INTO table1 (col1) VALUES (1);"}
   );
Copy

다음 예에서는 값을 바인딩합니다.

var stmt = snowflake.createStatement(
   {
   sqlText: "INSERT INTO table2 (col1, col2) VALUES (?, ?);",
   binds:["LiteralValue1", variable2]
   }
);
Copy

추가 예제를 포함하여 바인딩에 대한 자세한 내용은 변수 바인딩하기 를 참조하십시오.

execute(command)

SQL 명령을 실행합니다.

매개 변수

이 입력은 createStatement() 메서드에 대해 입력과 동일합니다.

반환

ResultSet 오브젝트 형식의 결과 세트.

오류

다음과 같은 경우 JavaScript 오류를 발생시킵니다.

  • 쿼리를 실행하는 동안 컴파일 오류와 같은 오류가 발생한 경우.

  • sqlText 가 없거나 빈 쿼리 텍스트를 포함하는 경우.

  • 이 문은 지원되지 않는 데이터 타입을 가진 인자를 바인딩하려고 하는 경우. 데이터 타입 매핑에 대한 자세한 내용은 SQL 및 JavaScript 데이터 타입 매핑 을 참조하십시오. 추가 예제를 포함하여 바인딩에 대한 자세한 내용은 변수 바인딩하기 를 참조하십시오.

참고

이 execute() 메서드(예: snowflake.execute())는 Statement 오브젝트(예: Statement.execute())의 메서드와 정확히 같지는 않습니다.

log(level, message)

지정된 심각도 수준에서 메시지를 로깅합니다.

매개 변수

level

메시지를 기록할 심각도 수준입니다. 다음 문자열 중 하나를 지정할 수 있습니다.

  • 'off'

  • 'trace'

  • 'debug'

  • 'info'

  • 'warn'

  • 'error'

  • 'fatal'

message

기록할 메시지입니다.

오류

다음과 같은 경우 JavaScript 오류를 발생시킵니다.

  • level 은 문자열이 아닙니다.

  • level 은 위에 나열된 지원되는 level 값 중 하나가 아닙니다.

예
snowflake.log("error", "Error message");
Copy
setSpanAttribute(key, value)

이벤트를 추적할 때 현재 범위의 특성을 설정합니다.

JavaScript에서 추적 이벤트에 대한 자세한 내용은 JavaScript에서 추적 이벤트 내보내기 섹션을 참조하십시오.

매개 변수

key

특성의 키입니다.

value

특성의 값입니다.

오류

다음과 같은 경우 JavaScript 오류를 발생시킵니다.

  • 두 인자가 지정되지 않았습니다.

  • key 는 문자열이 아닙니다.

예

키가 example.boolean 이고 값이 true 인 특성을 설정합니다.

snowflake.setSpanAttribute("example.boolean", true);
Copy

오브젝트: Statement

저장 프로시저 Statement 오브젝트는 쿼리 문을 실행하고 이 문에 대한 메타데이터(예: 열 데이터 타입)에 액세스하기 위한 메서드를 제공합니다.

Statement 오브젝트가 생성되는 시점에, SQL이 구문 분석되고 준비된 문이 생성됩니다.

상수

없습니다.

메서드

execute()

이 메서드는 이 Statement 오브젝트에 저장된 준비된 문을 실행합니다.

매개 변수

이 메서드는 Statement 오브젝트에 이미 저장된 정보를 사용하므로 없습니다.

반환

ResultSet 오브젝트 형식의 결과 세트.

오류

쿼리가 실패할 경우 JavaScript Error를 발생시킵니다.

예

저장 프로시저 작업하기 섹션을 참조하십시오.

참고

이 execute() 메서드(예: Statement.execute())는 snowflake 오브젝트(예: snowflake.execute())의 메서드와 정확히 같지는 않습니다.

snowflake.execute(statement_in_JSON_form) 에는 실행할 SQL 문인 매개 변수가 필요합니다. Statement.execute() 는 매개 변수를 받지 않으며, Statement 오브젝트가 생성될 때 지정했던 SQL 문을 사용합니다.

getColumnCount()

이 메서드는 실행된 쿼리에 대한 결과 세트의 열 개수를 반환합니다. 쿼리가 아직 실행되지 않은 경우 이 메서드는 Error를 발생시킵니다.

매개 변수

없습니다.

반환

열 개수.

오류

문이 아직 실행되지 않은 경우 JavaScript Error를 발생시킵니다(따라서 반환된 열의 수를 반드시 결정할 수 있는 것은 아님).

예
var column_count = statement.getColumnCount();
Copy
getColumnName(colIdx)

이 메서드는 지정된 열의 이름을 반환합니다.

매개 변수

열의 인덱스 번호(0 이 아니라 1 부터 시작함).

반환

열 이름.

오류

다음과 같은 경우 JavaScript 오류를 발생시킵니다.

  • Statement 가 아직 실행되지 않은 경우.

  • 지정된 인덱스를 가진 열이 없는 경우.

getColumnScale(colIdx)

이 메서드는 지정된 열의 소수 자릿수를 반환합니다. 소수 자릿수는 소수점 이하 자릿수입니다. 열의 소수 자릿수는 CREATE TABLE 문 또는 ALTER TABLE 문에 지정되었습니다. 예:

create table scale_example  (
    n10_4 numeric(10, 4)    // Precision is 10, Scale is 4.
    );
Copy

이 메서드는 모든 데이터 타입에 대해 호출할 수 있지만, 숫자 데이터 타입과 함께 사용하기 위한 메서드입니다.

매개 변수

소수 자릿수가 필요한 열의 인덱스(0 이 아니라 1 부터 시작함).

반환

열의 소수 자릿수(숫자 열의 경우). 숫자가 아닌 열의 경우에는 0.

오류

다음과 같은 경우 JavaScript 오류를 발생시킵니다.

  • Statement 가 아직 실행되지 않은 경우.

  • 지정된 인덱스를 가진 열이 없는 경우.

예

저장 프로시저 작업하기 를 참조하십시오(getColumnScale() 검색).

getColumnSqlType(colIdx|colName)

이 메서드는 지정된 열의 SQL 데이터 타입을 반환합니다.

매개 변수

열의 인덱스 번호(0 이 아니라 1 부터 시작함) 또는 열 이름. (다양한 데이터 타입을 매개 변수로 허용하도록 메서드가 오버로드됩니다.)

테이블 생성 시 열 이름에 큰따옴표를 사용하지 않은 경우(즉, 열 이름의 대/소문자가 유지됨) 열 이름은 모두 대문자여야 합니다.

반환

열의 SQL 데이터 타입.

오류

다음과 같은 경우 JavaScript 오류를 발생시킵니다.

  • Statement 가 아직 실행되지 않은 경우.

  • 지정된 이름 또는 인덱스를 가진 열이 없는 경우.

getColumnType(colIdx|colName)

이 메서드는 지정된 열의 JavaScript 데이터 타입을 반환합니다.

매개 변수

열의 인덱스 번호(0 이 아니라 1 부터 시작함) 또는 열 이름. (다양한 데이터 타입을 매개 변수로 허용하도록 메서드가 오버로드됩니다.)

테이블 생성 시 열 이름에 큰따옴표를 사용하지 않은 경우(즉, 열 이름의 대/소문자가 유지됨) 열 이름은 모두 대문자여야 합니다.

반환

열의 JavaScript 데이터 타입.

오류

다음과 같은 경우 JavaScript 오류를 발생시킵니다.

  • Statement 가 아직 실행되지 않은 경우.

  • 지정된 인덱스 또는 이름을 가진 열이 없는 경우.

getNumDuplicateRowsUpdated()

이 메서드는 이 문으로 업데이트된 《중복》 행(종종 다중 조인 행 이라고 함)의 수를 반환합니다. (다중 조인 행의 형성 방법에 대한 자세한 내용은 UPDATE 문에 대한 사용법 노트 및 예 를 참조하십시오.)

매개 변수

없습니다.

반환

업데이트된 다중 조인 행의 개수를 나타내는 Number 형식의 값.

오류

문이 아직 실행되지 않은 경우 JavaScript 오류를 발생시킵니다.

getNumRowsAffected()

이 메서드는 이 Statement의 영향을 받는(예: 삽입/업데이트/삭제된) 행의 개수를 반환합니다.

두 가지 이상의 변경 유형이 적용되는 경우(예: MERGE 작업이 어떤 행은 삽입하고 다른 행은 업데이트한 경우), 이 수는 모든 변경 사항의 영향을 받는 행의 총수입니다.

매개 변수

없습니다.

반환

영향을 받는 행의 개수를 나타내는 Number 형식의 값.

오류

문이 아직 실행되지 않은 경우 JavaScript 오류를 발생시킵니다.

getNumRowsDeleted()

이 메서드는 이 Statement로 삭제된 행의 개수를 반환합니다.

매개 변수

없습니다.

반환

삭제된 행의 개수를 나타내는 Number 형식의 값.

오류

문이 아직 실행되지 않은 경우 JavaScript 오류를 발생시킵니다.

getNumRowsInserted()

이 메서드는 이 Statement로 삽입된 행의 개수를 반환합니다.

매개 변수

없습니다.

반환

삽입된 행의 개수를 나타내는 Number 형식의 값.

오류

문이 아직 실행되지 않은 경우 JavaScript 오류를 발생시킵니다.

getNumRowsUpdated()

이 메서드는 이 Statement로 업데이트된 행의 개수를 반환합니다.

매개 변수

없습니다.

반환

업데이트된 행의 개수를 나타내는 Number 형식의 값.

오류

문이 아직 실행되지 않은 경우 JavaScript 오류를 발생시킵니다.

getRowCount()

이 메서드는 실행된 쿼리에 대한 결과 세트의 행 개수를 반환합니다. 쿼리가 아직 실행되지 않은 경우 이 메서드는 Error를 발생시킵니다.

매개 변수

없습니다.

반환

행 개수.

오류

문이 아직 실행되지 않은 경우 JavaScript Error를 발생시킵니다(따라서 반환된 행의 수를 결정할 수 없음).

예
var row_count = statement.getRowCount();
Copy
getQueryId()

이 메서드는 가장 최근에 실행된 쿼리의 UUID를 반환합니다.

매개 변수

없습니다.

반환

쿼리 ID인 UUID를 포함하는 문자열.

오류

이 문으로 실행한 쿼리가 아직 없는 경우 이 메서드는 《문이 아직 실행되지 않았습니다.》 오류를 발생시킵니다.

예
var queryId = statement.getQueryId();
Copy
getSqlText()

이 메서드는 Statement 오브젝트에서 준비된 쿼리의 텍스트를 반환합니다.

매개 변수

없습니다.

반환

준비된 쿼리 텍스트의 문자열.

오류

없습니다.

예
var queryText = statement.getSqlText();
Copy
isColumnNullable(colIdx)

이 메서드는 지정된 열에서 SQL NULL 값을 허용하는지 여부를 반환합니다.

매개 변수

열의 인덱스(0 이 아니라 1 부터 시작함).

반환

열에서 SQL NULL 값을 허용하는 경우 true, 그렇지 않으면 false.

오류

다음과 같은 경우 JavaScript 오류를 발생시킵니다.

  • Statement 가 아직 실행되지 않은 경우.

  • 지정된 인덱스를 가진 열이 없는 경우.

isColumnText(colIdx)

이 메서드는 열 데이터 타입이 다음 SQL 텍스트 데이터 타입 중 하나인 경우 true를 반환합니다.

  • CHAR 또는 CHAR(N)은 물론이고 그 동의어인 CHARACTER 및 CHARACTER(N)

  • VARCHAR 또는 VARCHAR(N)

  • STRING

  • TEXT

그렇지 않으면 false를 반환합니다.

매개 변수

열의 인덱스(0 이 아니라 1 부터 시작함).

반환

열 데이터 타입이 SQL 텍스트 데이터 타입 중 하나인 경우 true, 다른 모든 데이터 타입인 경우 false.

오류

다음과 같은 경우 JavaScript 오류를 발생시킵니다.

  • Statement 가 아직 실행되지 않은 경우.

  • 지정된 인덱스를 가진 열이 없는 경우.

참고

이 API는 열의 데이터 타입을 결정하는 여러 가지 방법을 제공합니다. 첫 번째 메서드는 위에 자세히 설명되어 있습니다. 나머지 메서드의 매개 변수와 오류도 똑같지만, 유일한 차이점은 반환 값입니다.

isColumnArray(colIdx)
반환

열 데이터 타입이 ARRAY(반정형 데이터에 대해)인 경우 true, 다른 모든 데이터 타입인 경우 false.

isColumnBinary(colIdx)
반환

열 데이터 타입이 BINARY 또는 VARBINARY인 경우 true, 다른 모든 데이터 타입인 경우 false.

isColumnBoolean(colIdx)
반환

열 데이터 타입이 BOOLEAN인 경우 true, 다른 모든 데이터 타입인 경우 false.

isColumnDate(colIdx)
반환

열 데이터 타입이 DATE인 경우 true, 다른 모든 데이터 타입인 경우 false.

isColumnNumber(colIdx)
반환

열 데이터 타입이 SQL 숫자 형식(NUMBER, NUMERIC, DECIMAL, INT, INTEGER, BIGINT, SMALLINT, TINYINT, BYTEINT, FLOAT, FLOAT4, FLOAT8, DOUBLE, DOUBLE PRECISION 또는 REAL) 중 하나인 경우 true, 다른 모든 데이터 타입인 경우 false.

isColumnObject(colIdx)
반환

열 데이터 타입이 OBJECT(반정형 데이터에 대해)인 경우 true, 다른 모든 데이터 타입인 경우 false.

isColumnTime(colIdx)
반환

열 데이터 타입이 TIME 또는 DATETIME인 경우 true, 다른 모든 데이터 타입인 경우 false.

isColumnTimestamp(colIdx)
반환

열 데이터 타입이 SQL 타임스탬프 형식(TIMESTAMP, TIMESTAMP_LTZ, TIMESTAMP_NTZ 또는 TIMESTAMP_TZ) 중 하나인 경우 true, 다른 날짜 및 시간 데이터 타입(DATE, TIME 또는 DATETIME)을 포함한 다른 모든 데이터 타입인 경우 false.

isColumnVariant(colIdx)
반환

열 데이터 타입이 VARIANT(반정형 데이터에 대해)인 경우 true, 다른 모든 데이터 타입인 경우 false.

오브젝트: ResultSet

이 오브젝트는 쿼리에서 반환된 결과를 포함합니다. 이런 결과는 각각 하나 이상의 열을 포함하는 0개 또는 그 이상의 행으로 구성된 세트로 처리됩니다. 《세트》라는 용어는 여기에서 수학적 의미로 사용되는 것이 아닙니다. 수학에서는 세트가 순서가 지정되지 않는 반면, ResultSet 는 순서가 있습니다.

ResultSet 는 어떤 면에서 SQL 커서의 개념과 유사합니다. 예를 들어, 커서에서 한 번에 한 행을 볼 수 있는 것과 마찬가지로, ResultSet 에서도 한 번에 한 행을 볼 수 있습니다.

일반적으로, ResultSet 를 불러온 후 다음 작업을 반복하여 이 오브젝트를 반복합니다.

  • next() 를 호출하여 다음 행을 가져옵니다.

  • getColumnValue() 와 같은 메서드를 호출하여 현재 행에서 데이터를 불러옵니다.

ResultSet 에 있는 데이터에 대해 충분히 알지 못하는 경우(예: 각 열의 데이터 타입을 모르는 경우), 데이터에 대한 정보를 제공하는 다른 메서드를 호출할 수 있습니다.

ResultSet 오브젝트의 메서드 중 일부는 Statement 오브젝트의 메서드와 유사합니다. 예를 들어 두 오브젝트 모두 getColumnSqlType(colIdx) 메서드가 있습니다.

상수

없습니다.

메서드

getColumnCount()

이 메서드는 이 ResultSet에 있는 열의 개수를 반환합니다.

매개 변수

없습니다.

반환

열의 개수를 나타내는 Number 형식의 값.

오류

없습니다.

getColumnSqlType(colIdx|colName)

이 메서드는 지정된 열의 SQL 데이터 타입을 반환합니다.

매개 변수

열의 인덱스 번호(0 이 아니라 1 부터 시작함) 또는 열 이름. (다양한 데이터 타입을 매개 변수로 허용하도록 메서드가 오버로드됩니다.)

테이블 생성 시 열 이름에 큰따옴표를 사용하지 않은 경우(즉, 열 이름의 대/소문자가 유지됨) 열 이름은 모두 대문자여야 합니다.

반환

열의 SQL 데이터 타입.

오류

다음과 같은 경우 JavaScript 오류를 발생시킵니다.

  • ResultSet 가 비어 있거나 next() 가 아직 호출되지 않은 경우.

  • 지정된 인덱스 또는 이름을 가진 열이 없는 경우.

getColumnValue(colIdx|colName)

이 메서드는 현재 행(즉, next() 로 가장 최근에 불러온 행)의 열 값을 반환합니다.

매개 변수

열의 인덱스 번호(0 이 아니라 1 부터 시작함) 또는 열 이름. (다양한 데이터 타입을 매개 변수로 허용하도록 메서드가 오버로드됩니다.)

테이블 생성 시 열 이름에 큰따옴표를 사용하지 않은 경우(즉, 열 이름의 대/소문자가 유지됨) 열 이름은 모두 대문자여야 합니다.

반환

지정된 열의 값.

오류

다음과 같은 경우 JavaScript 오류를 발생시킵니다.

  • ResultSet 가 비어 있거나 next() 가 아직 호출되지 않은 경우.

  • 지정된 인덱스 또는 이름을 가진 열이 없는 경우.

예

데이터베이스의 행을 JavaScript 배열로 변환합니다.

var valueArray = [];
// For each row...
while (myResultSet.next())  {
    // Append each column of the current row...
    valueArray.push(myResultSet.getColumnValue('MY_COLUMN_NAME1'));
    valueArray.push(myResultSet.getColumnValue('MY_COLUMN_NAME2'));
    ...
    // Do something with the row of data that we retrieved.
    f(valueArray);
    // Reset the array before getting the next row.
    valueArray = [];
    }
Copy

또한, 열의 값을 ResultSet 오브젝트의 속성(예: myResultSet.MY_COLUMN_NAME)으로 액세스할 수 있습니다.

var valueArray = [];
// For each row...
while (myResultSet.next())  {
    // Append each column of the current row...
    valueArray.push(myResultSet.MY_COLUMN_NAME1);
    valueArray.push(myResultSet.MY_COLUMN_NAME2);
    ...
    // Do something with the row of data that we retrieved.
    f(valueArray);
    // Reset the array before getting the next row.
    valueArray = [];
    }
Copy

참고

CREATE TABLE 문에서 큰따옴표로 열 이름을 구분하지 않은 경우 열 이름은 JavaScript 코드에서 모두 대문자여야 합니다.

getColumnValueAsString(colIdx|colName)

이 메서드는 열 값을 문자열로 반환하므로, 테이블의 원래 데이터 타입과 관계없이 열 값이 필요할 때 유용합니다.

이 메서드는 문자열 값을 반환한다는 점을 제외하면 getColumnValue() 메서드와 같습니다.

자세한 내용은 getColumnValue() 섹션을 참조하십시오.

getNumRowsAffected()

이 메서드는 이 ResultSet를 생성한 Statement의 영향을 받는(예: 삽입/업데이트/삭제된) 행의 개수를 반환합니다.

두 가지 이상의 변경 유형이 적용되는 경우(예: MERGE 작업이 어떤 행은 삽입하고 다른 행은 업데이트한 경우), 이 수는 모든 변경 사항의 영향을 받는 행의 총수입니다.

매개 변수

없습니다.

반환

영향을 받는 행의 개수를 나타내는 Number 형식의 값.

오류

없습니다.

getQueryId()

이 메서드는 가장 최근에 실행된 쿼리의 UUID를 반환합니다.

매개 변수

없습니다.

반환

쿼리 ID인 UUID를 포함하는 문자열.

예
var queryId = resultSet.getQueryId();
Copy
getRowCount()

이 메서드는 이 ResultSet에 있는 행의 개수를 반환합니다. (이는 아직 사용되지 않은 행의 수가 아니라, 행의 총수입니다.)

매개 변수

없습니다.

반환

행의 개수를 나타내는 Number 형식의 값.

오류

없습니다.

next()

이 메서드는 ResultSet 에서 그다음 행을 가져와서 액세스할 수 있게 합니다.

이 메서드는 새 데이터 행을 반환하지 않습니다. 대신에, 데이터를 불러오기 위해 ResultSet.getColumnValue() 와 같은 메서드를 호출할 수 있도록 행을 사용할 수 있게 합니다.

첫 번째 행을 포함하여 결과 세트의 각 행에 대해 next() 를 호출해야 합니다.

매개 변수

없습니다.

반환

행을 불러온 경우 true, 불러올 행이 더 이상 없는 경우 false.

따라서 next() 가 false를 반환할 때까지 ResultSet 를 반복할 수 있습니다.

오류

없습니다.

오브젝트: SfDate

JavaScript에는 Snowflake SQL 데이터 타입 TIMESTAMP_LTZ, TIMESTAMP_NTZ, TIMESTAMP_TZ에 해당하는 네이티브 데이터 타입이 없습니다. 데이터베이스에서 TIMESTAMP 형식의 값을 불러와 JavaScript 변수로 저장하고 싶은 경우(예: ResultSet에서 이 값을 JavaScript 변수에 복사), Snowflake 정의 JavaScript 데이터 타입 SfDate 를 사용하십시오. SfDate (《SnowFlake Date》) 데이터 타입은 JavaScript 날짜 데이터 타입의 확장입니다. SfDate 에는 아래에서 설명하는 추가 메서드가 있습니다.

상수

없습니다.

메서드

달리 지정하지 않는 한, 아래의 예에서는 UTC 타임존으로 가정합니다.

getEpochSeconds()

이 메서드는 《epoch(시대)》의 시작(1970년 1월 1일 자정) 이후로 경과된 시간(초)을 반환합니다.

매개 변수

없습니다.

반환

1970년 1월 1일 자정과 변수에 저장된 타임스탬프 사이의 시간(초).

예

저장 프로시저를 만듭니다.

CREATE OR REPLACE PROCEDURE test_get_epoch_seconds(TSV VARCHAR)
    RETURNS FLOAT
    LANGUAGE JAVASCRIPT
    AS
    $$
    var sql_command = "SELECT '" + TSV + "'::TIMESTAMP_NTZ;";
    var stmt = snowflake.createStatement( {sqlText: sql_command} );
    var resultSet = stmt.execute();
    resultSet.next();
    var my_sfDate = resultSet.getColumnValue(1);
    return my_sfDate.getEpochSeconds();
    $$
    ;
Copy

프로시저에 다른 타임스탬프를 전달하고 각 타임스탬프에 대해 epoch 이후 경과된 시간(초)을 불러옵니다.

CALL test_get_epoch_seconds('1970-01-01 00:00:00.000000000');
+------------------------+
| TEST_GET_EPOCH_SECONDS |
|------------------------|
|                      0 |
+------------------------+
Copy
CALL test_get_epoch_seconds('1970-01-01 00:00:01.987654321');
+------------------------+
| TEST_GET_EPOCH_SECONDS |
|------------------------|
|                      1 |
+------------------------+
Copy
CALL test_get_epoch_seconds('1971-01-01 00:00:00');
+------------------------+
| TEST_GET_EPOCH_SECONDS |
|------------------------|
|               31536000 |
+------------------------+
Copy
getNanoSeconds()

이 메서드는 오브젝트의 나노초 필드 값을 반환합니다. 이 값은 epoch 시작 이후의 나노초가 아니라 소수 초일 뿐입니다. 따라서 이 값은 항상 0에서 999999999 사이의 값입니다.

매개 변수

없습니다.

반환

나노초 수.

예

저장 프로시저를 만듭니다.

CREATE OR REPLACE PROCEDURE test_get_nano_seconds2(TSV VARCHAR)
    RETURNS FLOAT
    LANGUAGE JAVASCRIPT
    AS
    $$
    var sql_command = "SELECT '" + TSV + "'::TIMESTAMP_NTZ;";
    var stmt = snowflake.createStatement( {sqlText: sql_command} );
    var resultSet = stmt.execute();
    resultSet.next();
    var my_sfDate = resultSet.getColumnValue(1);
    return my_sfDate.getNanoSeconds();
    $$
    ;
-- Should be 0 nanoseconds.
-- (> SNIPPET_TAG=query_03_01
CALL test_get_nano_seconds2('1970-01-01 00:00:00.000000000');
Copy

프로시저에 다른 타임스탬프를 전달하고 각각에서 나노초 수를 불러옵니다.

CALL test_get_nano_seconds2('1970-01-01 00:00:00.000000000');
+------------------------+
| TEST_GET_NANO_SECONDS2 |
|------------------------|
|                      0 |
+------------------------+
Copy
CALL test_get_nano_seconds2('1970-01-01 00:00:01.987654321');
+------------------------+
| TEST_GET_NANO_SECONDS2 |
|------------------------|
|              987654321 |
+------------------------+
Copy
CALL test_get_nano_seconds2('1971-01-01 00:00:00.000123456');
+------------------------+
| TEST_GET_NANO_SECONDS2 |
|------------------------|
|                 123456 |
+------------------------+
Copy
getScale()

이 메서드는 데이터 타입의 정밀도, 즉 소수점 이하 자릿수를 반환합니다. 예를 들어, TIMESTAMP_NTZ(3)의 정밀도는 3(밀리초)입니다. TIMESTAMP_NTZ(0)의 정밀도는 0(소수 초 없음)입니다. TIMSTAMP_NTZ의 정밀도는 9(나노초)입니다.

최소값은 0이고 최대값은 9입니다(정밀도가 1나노초까지임). 기본 정밀도는 9입니다.

매개 변수

없습니다.

반환

소수점 이하 자릿수(소수 초 필드의 자릿수).

예

저장 프로시저를 만듭니다.

CREATE OR REPLACE PROCEDURE test_get_scale(TSV VARCHAR, SCALE VARCHAR)
    RETURNS FLOAT
    LANGUAGE JAVASCRIPT
    AS
    $$
    var sql_command = "SELECT '" + TSV + "'::TIMESTAMP_NTZ(" + SCALE + ");";
    var stmt = snowflake.createStatement( {sqlText: sql_command} );
    var resultSet = stmt.execute();
    resultSet.next();
    var my_sfDate = resultSet.getColumnValue(1);
    return my_sfDate.getScale();
    $$
    ;

-- Should be 0.
-- (> SNIPPET_TAG=query_04_01
CALL test_get_scale('1970-01-01 00:00:00', '0');
Copy

이 예에서는 타임스탬프가 TIMESTAMP_NTZ(0)으로 정의되므로, 정밀도는 0입니다.

CALL test_get_scale('1970-01-01 00:00:00', '0');
+----------------+
| TEST_GET_SCALE |
|----------------|
|              0 |
+----------------+
Copy

이 예에서는 타임스탬프가 TIMESTAMP_NTZ(2)로 정의되므로, 정밀도는 2입니다.

CALL test_get_scale('1970-01-01 00:00:01.123', '2');
+----------------+
| TEST_GET_SCALE |
|----------------|
|              2 |
+----------------+
Copy

이 예에서는 타임스탬프가 TIMESTAMP_NTZ로 정의되므로, 정밀도는 기본값인 9입니다.

CALL test_get_scale('1971-01-01 00:00:00.000123456', '9');
+----------------+
| TEST_GET_SCALE |
|----------------|
|              9 |
+----------------+
Copy
getTimezone()

이 메서드는 타임존을 UTC 이전 또는 이후의 시간(분)으로 반환합니다.

매개 변수

없습니다.

반환

UTC 이전 또는 이후의 시간(분)으로 나타낸 타임존.

예

저장 프로시저를 만듭니다.

CREATE OR REPLACE PROCEDURE test_get_Timezone(TSV VARCHAR)
    RETURNS FLOAT
    LANGUAGE JAVASCRIPT
    AS
    $$
    var sql_command = "SELECT '" + TSV + "'::TIMESTAMP_TZ;";
    var stmt = snowflake.createStatement( {sqlText: sql_command} );
    var resultSet = stmt.execute();
    resultSet.next();
    var my_sfDate = resultSet.getColumnValue(1);
    return my_sfDate.getTimezone();
    $$
    ;
Copy

이 예에서는 타임존이 UTC보다 8시간(480분) 뒤의 시간입니다.

CALL test_get_timezone('1970-01-01 00:00:01-08:00');
+-------------------+
| TEST_GET_TIMEZONE |
|-------------------|
|              -480 |
+-------------------+
Copy

이 예에서는 타임존이 UTC보다 11시간(660분) 앞의 시간입니다.

CALL test_get_timezone('1971-01-01 00:00:00.000123456+11:00');
+-------------------+
| TEST_GET_TIMEZONE |
|-------------------|
|               660 |
+-------------------+
Copy
toString()
매개 변수

없습니다.

반환

이 메서드는 타임스탬프의 문자열 표현을 반환합니다.

예

다음은 SfDate 를 만들고 toString 메서드를 호출하는 간단한 예를 보여줍니다.

CREATE OR REPLACE PROCEDURE test_toString(TSV VARCHAR)
    RETURNS VARIANT
    LANGUAGE JAVASCRIPT
    AS
    $$
    var sql_command = "SELECT '" + TSV + "'::TIMESTAMP_TZ;";
    var stmt = snowflake.createStatement( {sqlText: sql_command} );
    var resultSet = stmt.execute();
    resultSet.next();
    var my_sfDate = resultSet.getColumnValue(1);
    return my_sfDate.toString();
    $$
    ;
Copy
CALL test_toString('1970-01-02 03:04:05');
+------------------------------------------------------------------+
| TEST_TOSTRING                                                    |
|------------------------------------------------------------------|
| "Fri Jan 02 1970 03:04:05 GMT+0000 (Coordinated Universal Time)" |
+------------------------------------------------------------------+
Copy
언어: 한국어