Snowpark Migration Accelerator: SMA CLI 사용

설명

Snowpark Migration Accelerator(SMA)는 다양한 작업을 수행할 수 있는 명령줄 인터페이스(CLI)를 제공합니다. CLI 를 사용하여 코드 프로세서를 실행하고, 액세스 코드를 관리(설치 또는 표시)하고, SMA 애플리케이션에서 사용 가능한 기타 작업을 수행할 수 있습니다.

SMA 는 모든 지원 소스 플랫폼에서 작동하는 단일 코드 프로세서를 사용합니다. 이 프로세서에 대한 추가 인자를 제공할 필요가 없습니다.

설치

명령줄 인터페이스(CLI)를 설치하기 전에 다운로드를 액세스할 수 있는 위치에 저장해야 합니다. 사용 중인 시스템에 맞는 설치 가이드를 선택하십시오.

명령

도구를 실행하려면 요구 사항에 따라 명령 시퀀스를 설정해야 합니다. 다음 구문으로 긴 명령 또는 짧은 명령 옵션을 사용할 수 있습니다.

sma [command] [argument] [command] [argument] ...
Copy

다음 명령을 사용할 수 있습니다. 명령을 클릭하면 해당 명령에 대한 자세한 설명을 볼 수 있습니다.

Long-commandShort-CommandDescription
--help-hDisplays help documentation.
--version-vDisplays current tool version.
install-access-codeinstall-acInstalls a new access code.
show-access-codeshow-acDisplays all installed access codes.
--input-iSpecifies the input folder location.
--output-oSpecifies the output folder location.
--assessment-aRuns the tool in assessment mode.
--mapDirectory-mSpecifies the folder containing custom mapping files.
--enableJupyter-jEnables or disables conversion of Databricks notebooks to Jupyter format.
--sql-fSpecifies which database engine syntax to use for SQL commands.
--customerEmail-eSets the customer email address.
--customerCompany-cSets the customer company name.
--projectName-pSets the project name.
--yes-ySkips confirmation prompts during execution.

액세스 코드 설치하기

코드 변환 프로세스를 시작하려면 먼저 액세스 코드를 설치해야 합니다. 이 작업은 두 가지 방법으로 수행할 수 있습니다.

  1. 액세스 코드를 직접 입력하십시오

  2. 액세스 코드가 포함된 파일의 경로를 입력합니다(이 방법은 오프라인 또는 제한적인 방화벽 뒤에서 작업할 때 유용합니다)

다음 명령을 실행하여 액세스 코드를 설치할 수 있습니다.

sma install-access-code <access-code>
Copy

이 명령은 이전 명령과 동일한 결과를 생성합니다.

sma install-ac <access-code>
Copy

파일에서 액세스 코드를 설치하려면 다음과 같이 --file 또는 -f 옵션 중 하나를 명령과 함께 사용합니다.

sma install-access-code --file <path-to-file>
or
sma install-access-code -f <path-to-file>
Copy

라이선스를 설치하는 동안 오류가 발생하면 오류 메시지가 표시됩니다.

액세스 코드를 요청하려면 sma-support@Snowflake.com으로 문의하시기 바랍니다

설치된 액세스 코드 확인

현재 컴퓨터에 어떤 액세스 코드가 설치되어 있는지 확인하려면 이 명령을 사용하십시오.

sma show-access-code
Copy

이 명령은 현재 컴퓨터에 설치된 모든 액세스 코드에 대한 세부 정보를 표시합니다.

변환

유효한 라이선스를 설치한 후 코드 프로세서를 실행하여 코드를 변환할 수 있습니다. 변환 프로세스를 시작하려면 다음과 같은 필수 인자를 제공해야 합니다.

  • 입력 경로: 원본 소스 코드가 들어있는 폴더

  • 출력 경로: 변환된 코드를 저장할 폴더입니다

프로젝트 정보

코드 프로세서를 처음 실행할 때는 특정 인자를 제공해야 합니다. 이러한 인자는 저장되어 향후 실행에 사용됩니다. 필수 인자는 애플리케이션에서 새 프로젝트를 만들 때 필요한 필수 인자와 동일합니다.

  • 고객 이메일: 유효한 이메일 주소를 입력합니다

  • 고객 회사: 회사 이름을 입력합니다

  • 프로젝트 이름: 프로젝트의 이름을 입력합니다

이 예제는 필수 요구 사항만 사용하여 코드 프로세서를 실행하는 방법을 보여줍니다.

sma -i <input-path> -o <output-path> -e <client email> -c <client company> -p <project name> <additional-parameters>
Copy

명령 시퀀스를 입력하고 “Enter”를 누르면 도구에 현재 설정이 표시되고 프로세스를 시작하기 전에 확인을 요청합니다.

프로세스 시작 전 현재 구성

인자를 추가하거나 수정하시겠습니까? 취소하려면 “n”을 입력하고 계속하려면 “y”를 입력합니다.

프로젝트 확인 건너뛰기

위에 표시된 확인 메시지를 건너뛰려면 –yes 또는 -y 를 인자로 추가합니다. 이 매개 변수가 없으면 매번 확인 메시지가 표시되므로 프로그래밍 방식으로 도구를 사용할 때 특히 중요합니다.

사용 가능한 모든 매개 변수에 대한 자세한 내용은 링크를 참조하십시오.

평가 수행하기

평가를 수행할 때 표준 변환 명령에 --assessment 또는 -a 옵션을 추가하십시오. 다음은 명령이 어떻게 표시되어야 하는지에 대한 예시입니다.

sma --input <input-path> --output <output-path> --assessment <additional-parameters>
Copy

이러한 각 명령은 추가 매개 변수를 허용할 수 있습니다. 자세한 내용은 ‘변환하기’ 섹션을 참조하십시오.

도구 버전 확인하기

도구 버전과 코드 처리 엔진을 확인하려면 다음 명령 중 하나를 사용하면 됩니다.

sma --version
sma -v
Copy

Databricks Notebooks을 Jupyter Notebooks으로 변환 활성화

이 옵션은 Python(.python) 및/또는 Scala(.scala) 소스 파일을 Jupyter Notebook(.ipynb) 파일로 변환합니다. 변환은 원본 파일이 노트북에서 내보낸 파일인지, 일반 코드 파일인지에 관계없이 작동합니다.

Jupyter 노트북을 변환하려면 '--enableJupyter' 플래그 또는 단축 버전 '-j' 를 명령어에 추가하십시오.

sma -i <input-path> -o <output-path> --enableJupyter
Copy

소스 코드의 SQL Flavor 설정하기

SQL 명령이 감지될 때 사용할 SQL 구문을 지정할 수 있습니다. '--sql' 또는 바로 가기 '-f' 명령을 사용합니다. 지원되는 구문 옵션은 ‘SparkSql’(기본값) 및 ‘HiveSql’입니다.

sma --input <input-path> --output <output-path> --sql SparkSql
sma --input <input-path> --output <output-path> --sql HiveSql
Copy

도움이 더 필요하신가요?

명령줄 인터페이스(CLI)에 대한 일반 도움말 정보를 보려면 다음 명령 중 하나를 사용하면 됩니다.

sma --help
sma -h
Copy

도움말 정보

특정 명령에 대해 자세히 알아보려면 이 명령을 실행하면 됩니다.

sma <command> --help
Copy

액세스 코드 설치에 대해 자세히 알아보려면 sma install-access-code --help 명령을 실행합니다.

언어: 한국어