다음을 통해 공유


BASE64_ENCODE(Transact-SQL)

적용 대상:Microsoft Fabric의 Azure SQL DatabaseSQL 분석 엔드포인트 및 웨어하우스

BASE64_ENCODE varbinary 식의 값을 base64로 인코딩된 varchar 식으로 변환합니다.

Transact-SQL 구문 표기 규칙

구문

BASE64_ENCODE (expression [ , url_safe ] )

인수

expression

varbinary(n) 또는 varbinary(max)형식 식입니다.

url_safe

인코딩 작업의 출력이 URL로부터 안전한지 여부를 지정하는 선택적 정수 리터럴 또는 식입니다. true로 평가되는 숫자가 아닌 0 모든 숫자입니다. 기본값은 0입니다.

반환 형식

  • varchar(8000) 입력이 varbinary(n) 경우 n<= 6000입니다.
  • varchar(max)는 입력이 n> 6000인 varbinary(n) 경우.
  • 입력이 varbinary(max) 경우 varchar(max) .
  • 입력 식이 NULL면 출력은 .입니다 NULL.

설명

인코딩된 문자열 알파벳은 rfC 4648 표 1 패딩을 추가할 수 있습니다. URL 안전 출력은 RFC 4648 표 2base64url 알파벳을 사용하며 패딩을 추가하지 않습니다. 이 함수는 새 줄 문자를 추가하지 않습니다.

각 경우에 데이터베이스 기본 데이터 정렬이 사용됩니다. Microsoft Fabric에서 지원되는 데이터 정렬에 대한 자세한 내용은 테이블을 참조 하세요.

true이면 url_safe 생성된 base64url 문자열이 SQL Server의 XML 및 JSON base64 디코더와 호환되지 않습니다.

예제

A. 표준 BASE64_ENCODE

다음 예제에서는 © 기호에 대해 base64로 인코딩된 값을 반환합니다.

SELECT Base64_Encode(0xA9) AS "Encoded © symbol";

결과 집합은 다음과 같습니다.

qQ==

B. 문자열 BASE64_ENCODE

다음 예제에서는 문자열이 base64로 인코딩됩니다. 문자열은 먼저 varbinary로 캐스팅되어야 합니다.

SELECT BASE64_ENCODE(CAST ('hello world' AS VARBINARY));

결과 집합은 다음과 같습니다.

aGVsbG8gd29ybGQ=

C. BASE64_ENCODE 기본값과 url_safe

다음 예제에서 첫 번째 선택에서는 url_safe지정하지 않습니다. 그러나 두 번째 선택에서는 url_safe지정합니다.

SELECT BASE64_ENCODE(0xCAFECAFE);

결과 집합은 다음과 같습니다.

yv7K/g==

다음 예제에서는 출력이 URL로부터 안전한지 지정합니다.

SELECT BASE64_ENCODE(0xCAFECAFE, 1);

결과 집합은 다음과 같습니다.

yv7K_g