사용되지 않는 기능

이 항목에서는 Snowflake 버전 5.40에서 더 이상 사용되지 않는 Snowflake SQL API의 기능에 대해 설명합니다.

SQL API의 현재 동작에 대한 정보는 Snowflake SQL REST API 섹션을 참조하십시오.

이 항목의 내용:

더 이상 사용되지 않는 SQL API 기능 사용하기

SQL API의 현재 버전 은 기본적으로 활성화되어 있습니다. 더 이상 사용되지 않는 버전에 액세스하려면 다음 엔드포인트를 사용하십시오.

엔드포인트

설명

/api/statements/

이 엔드포인트를 사용하여 실행할 SQL 문을 제출합니다.

/api/statements/statementHandle

이 엔드포인트를 사용하여 문 실행 상태를 확인 합니다. (statementHandle 은 실행을 위해 제출된 문에 대한 고유 식별자입니다.)

/api/statements/statementHandle/cancel

이 엔드포인트를 사용하여 문 실행을 취소합니다.

참고

이러한 엔드포인트는 더 이상 지원되지 않으며 이전 버전과의 호환성을 위해서만 제공됩니다. 향후 릴리스에서는 비활성화됩니다.

변경되고 사용되지 않는 기능

더 이상 사용되지 않는 SQL API 기능을 사용할 때 pageSize 요청 매개 변수를 설정하여 결과를 페이지로 나누면 Snowflake는 응답의 첫 번째 결과 페이지를 반환합니다. ResultSet 오브젝트의 ResultSet_resultSetMetaData 오브젝트에 있는 numPages 필드를 사용하여 결과의 총 페이지 수를 결정할 수 있습니다.

결과의 다음 페이지 또는 다른 결과 페이지를 가져오려면 HTTP 응답의 Link 헤더에 제공된 URL을 사용하십시오. Link 헤더는 결과의 첫 번째, 다음, 이전, 마지막 페이지를 검색하기 위한 URL을 지정합니다.

다음 기능은 변경되거나 더 이상 사용되지 않습니다.

  • GET 및 POST 요청 둘 다에서 nullable 매개 변수를 지정할 수 있습니다.

  • pageSize 매개 변수를 사용하여, 쿼리에서 반환된 행 수를 지정합니다. 페이지 크기의 범위는 페이지당 지원되는 최소 행 수(10)에서 지원되는 최대 행 수(10000)까지입니다. 기본적으로, 반환되는 행 수는 문 실행에 따라 다릅니다.

  • page 를 사용하여, 반환할 결과 페이지를 식별합니다. 숫자 범위는 0부터, 총 페이지 수에서 1을 뺀 값까지입니다.

  • 행 번호는 기본적으로 데이터 세트의 일부로 반환됩니다.

결과 세트 페이지 크기가 제한을 초과하는지 확인하기

SQL API에서 더 이상 사용되지 않는 기능은 최대 크기가 약 10MB인 결과 세트 페이지를 반환할 수 있습니다.

결과 세트 페이지가 이 크기를 초과하면 엔드포인트는 본문에 잘린 결과 세트와 391908 로 설정된 code 필드가 포함된 HTTP 200 응답을 반환합니다.

HTTP/1.1 200 OK
...
{
  "code": "391908",
  ...
}
Copy

이 경우, 페이지의 최대 크기에 맞는 더 작은 값으로 설정한 pageSize 매개 변수를 사용하여 요청을 다시 보내십시오.