try_copy_file 함수

적용 대상:yes Databricks SQL 확인 표시 예 Databricks Runtime 18 LTS 이상으로 표시

Important

이 기능은 베타 버전으로 제공됩니다. 작업 영역 관리자는 미리 보기 페이지에서 이 기능에 대한 액세스를 제어할 수 있습니다. Azure Databricks 미리 보기 관리를 참조하세요.

파일을 목적지 경로로 복사하고 참조를 FILE 반환하거나, NULL 소스 파일이 존재하지 않거나 접근할 수 없을 때 반환합니다. Unity 카탈로그 관리 저장소로 파일을 복사하는 것은 생략 destination 하세요. 이 저장소는 참조를 FILE EXTERNAL 참조로 FILE MANAGED 변환합니다.

Syntax

try_copy_file(file => file
  [, destination => destination ]
  [, if_file_exists_mode => mode ])

논증은 위치별로 또는 이름으로 전달할 수 있습니다. 인수명을 이름으로 전달한 후에는 그 이후의 모든 인수도 이름으로 전달되어야 합니다. 자세한 내용은 이름 있는 매개변수 호출을 참조하세요.

Arguments

  • file: FILE 복사할 값입니다.
  • destination: 전체 목적지 파일 경로가 포함된 선택 STRING 사항으로, 단순한 디렉터리가 아닙니다. 생략 시 파일은 Unity Catalog가 관리하는 저장소로 복사되어 참조를 FILE EXTERNAL 참조로 FILE MANAGED 변환합니다.
  • if_file_exists_mode: 목적지 경로에 파일이 이미 존재할 때 동작을 설정하는 선택적 STRING 기능입니다. 논증을 destination 사용할 때만 적용됩니다. 허용된 값(대문자 구분 없음)은 다음과 같습니다:
    • 'error': 오류가 발생한다. 기본값입니다.
    • 'overwrite': 기존 파일을 덮어씁니다.
    • 'skip': 복사를 건너뛰고 기존 파일에 대한 참조를 FILE 반환합니다.

Returns

FILE 복사된 파일을 참조하는 값이거나, NULL 소스 파일이 존재하지 않거나 접근할 수 없는 경우를 참조하는 값입니다.

Notes

  • 이 함수는 오류 허용 함수 버전copy_file입니다. 참조를 FILE EXTERNAL 참조로 FILE MANAGED 변환할 때 오류를 무시하는 데 사용하세요. 변환이 명시적(누락destination)이든 자동적(열에 FILE MANAGED 값을 삽입하는 FILE EXTERNAL 것)이든 상관없습니다.
  • 목적지 경로에 이미 파일이 존재하면, Azure Databricks는 기본적으로 if_file_exists_modeoverwriteskip오류를 발생시킵니다.

일반적인 오류 조건

  • COPY_FILE_ERROR.FILE_ALREADY_EXISTS
  • COPY_FILE_AUTHORIZATION_ERROR.WRITE_UNAUTHORIZED

자세한 내용은 Azure Databricks의 Error conditions 문서를 참조하세요.

예시

소스 파일이 존재 try_copy_file 하지 않으면 다음을 반환 NULL합니다:

SELECT try_copy_file(deleted_file, destination => '/Volumes/archive/reports/report.pdf');

NULL

Unity 카탈로그 관리 저장소에 파일을 복사하고 참조를 참조로 FILE MANAGED 변환하려면 FILE EXTERNAL 목적지를 생략하세요:

SELECT try_copy_file(to_file('/Volumes/source/data/input.csv'));

파일을 복사하고 기존 목적지 파일을 덮어쓰려면:

SELECT try_copy_file(
  to_file('/Volumes/source/reports/report.pdf'),
  destination => '/Volumes/archive/reports/report.pdf',
  if_file_exists_mode => 'overwrite'
);
  • Last updated on