Snowpark Migration Accelerator: SMA CLI 사용¶

설명¶

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

The SMA uses a single code processor that works with all supported source platforms. You don’t need to provide any additional arguments for this processor.

설치¶

Before installing the Command Line Interface (CLI), you need to download it to a location you can access. Choose the installation guide that matches your operating system:

명령¶

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

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

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


긴 명령	짧은 명령	설명
–help	-h	도움말 설명서를 표시합니다.
–version	-v	현재 도구 버전을 표시합니다.
install-access-code	install-ac	새 액세스 코드를 설치합니다.
show-access-code	show-ac	설치된 모든 액세스 코드를 표시합니다.
–input	-i	입력 폴더 위치를 지정합니다.
–output	-o	출력 폴더 위치를 지정합니다.
–assessment	-a	평가 모드에서 도구를 실행합니다.
–mapDirectory	-m	사용자 지정 매핑 파일이 포함된 폴더를 지정합니다.
–enableJupyter	-j	Databricks 노트북을 Jupyter 형식으로 변환하는 기능을 활성화하거나 비활성화합니다.
–sql	-f	SQL 명령에 사용할 데이터베이스 엔진 구문을 지정합니다.
–customerEmail	-e	고객 이메일 주소를 설정합니다.
–customerCompany	-c	고객 회사 이름을 설정합니다.
–projectName	-p	프로젝트 이름을 설정합니다.
–yes	-y	실행 중에 확인 메시지를 건너뜁니다.

액세스 코드 설치하기¶

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

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

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

sma install-access-code <access-code>

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

sma install-ac <access-code>

To install an access code from a file, use either the --file or -f option with your command, like this:

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

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

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

설치된 액세스 코드 확인¶

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

sma show-access-code

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

변환¶

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

입력 경로: 원본 소스 코드가 들어있는 폴더
출력 경로: 변환된 코드를 저장할 폴더입니다

프로젝트 정보¶

When you run the code processor for the first time, you need to provide certain arguments. These arguments will be saved and used for future executions. The required arguments are the same as those needed when creating a new project in the application.

고객 이메일: 유효한 이메일 주소를 입력합니다
고객 회사: 회사 이름을 입력합니다
프로젝트 이름: 프로젝트의 이름을 입력합니다

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

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

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

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

프로젝트 확인 건너뛰기¶

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

For more information about all available parameters, please refer to this link.

평가 수행하기¶

When performing an assessment, add the --assessment or -a option to the standard conversion commands. Here are examples of how the commands should look:

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

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

도구 버전 확인하기¶

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

sma --version
sma -v

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

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

To convert Jupyter notebooks, add either the '--enableJupyter' flag or its shorthand version '-j' to your command.

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

소스 코드의 SQL Flavor 설정하기¶

You can specify which SQL syntax to use when a SQL command is detected. Use either the command '--sql' or its shortcut '-f'. The supported syntax options are ‘SparkSql’ (which is the default), ‘HiveSql’, and ‘Databricks’.

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

도움이 더 필요하신가요?¶

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

sma --help
sma -h

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

sma <command> --help

To learn more about installing an access code, run the command sma install-access-code --help.