Share via


BASE64_ENCODE(Transact-SQL)

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

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

Transact-SQL 구문 표기 규칙

구문

BASE64_ENCODE (expression [, url_safe])

인수

expression

varbinary 형식의 식(n | max)

url_safe

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

반환 형식

  • Varchar(8000)
  • 입력이 varbinary(max) 인 경우 Varchar(max)
  • 입력이 varchar(n) 이면 varchar(max)이고 여기서 n > 은 6000입니다.
  • 입력 식이 null면 출력은 .입니다 null.

설명

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

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

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

예제

A. 표준 BASE64_ENCODE

다음 예제에서 단순 varbinary는 base64로 인코딩됩니다.

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

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

------------  
qQ==
(1 row affected)

B. 문자열 BASE64_ENCODE

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

SELECT BASE64_ENCODE (CAST ('hello world' as varbinary))

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

------------  
aGVsbG8gd29ybGQ=
(1 row affected)

C. BASE64_ENCODE 기본값과 url_safe

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

SELECT BASE64_ENCODE(0xCAFECAFE)

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

------------  
yv7K/g==
(1 row affected)

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

SELECT BASE64_ENCODE(0xCAFECAFE, 1);

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

------------  
yv7K_g
(1 row affected)

다음 단계