적용 대상:✅Microsoft Fabric의 SQL 데이터베이스
패브릭 CLI( 명령줄 인터페이스 )를 사용하여 Fabric에서 SQL 데이터베이스를 만들 수 있습니다. Fabric CLI(fab)는 Microsoft Fabric용 파일 시스템에서 영감을 받은 빠른 명령줄 인터페이스입니다.
이 문서 및 샘플 스크립트는 패브릭 SQL 데이터베이스를 배포하는 데 사용할 수 있는 기본 패브릭 CLI 명령을 보여 줍니다.
필수 조건
시작하기 전에 다음을 수행하십시오.
Fabric의 기존 용량이 필요합니다. 그렇지 않은 경우 Fabric 평가판을 시작합니다.
기존 작업 영역을 사용하거나 새 패브릭 작업 영역을 만들 수 있습니다.
SQL 데이터베이스를 만들려면 작업 영역에 대한 관리자 또는 멤버 역할의 멤버 여야 합니다.
Python 버전 3.10, 3.11 또는 3.12가 컴퓨터에 설치되어 있는지 확인합니다. Python은 환경 변수를 통해
PATH터미널에서 액세스할 수 있어야 합니다.다음 명령을 사용하여 컴퓨터에 Fabric CLI를 설치합니다. 설치 관리자의 출력에서
PATH를 업데이트해야 한다는 메시지가 표시되면 계속하기 전에 수정하거나 후속 단계가 실패할 수 있습니다.pip install ms-fabric-cli
패브릭 CLI를 사용하여 새 SQL 데이터베이스 만들기
Microsoft Fabric에 로그인합니다. 명령 프롬프트를 열고 다음 명령을 실행합니다.
fab auth login프롬프트에 따라 패브릭 작업 영역에 대한 액세스 권한이 있는 Microsoft 계정을 사용하여 인증합니다.
다음 명령을 실행하여 새 SQL 데이터베이스를 만듭니다.
- SQL 데이터베이스를 만들고자 하는 작업 영역의 이름으로
<workspacename>을(를) 바꾸세요. -
<databasename>을 새 SQL 데이터베이스에 사용할 이름으로 바꾸십시오.
fab create <workspacename>.Workspace/<databasename>.SQLDatabase- SQL 데이터베이스를 만들고자 하는 작업 영역의 이름으로
다음 명령을 사용하여 작업 영역에서 새 SQL 데이터베이스를 확인합니다.
- SQL 데이터베이스를 만들고자 하는 작업 영역의 이름으로
<workspacename>을(를) 바꾸세요.
fab ls <workspacename>.Workspace이
fab ls명령은 새 SQL 데이터베이스를 포함하여 작업 영역의 모든 항목 목록을 표시합니다.- SQL 데이터베이스를 만들고자 하는 작업 영역의 이름으로
데이터베이스 데이터 정렬
기본적으로 데이터베이스는 대/소문자를 구분하지 않는 데이터 정렬 SQL_Latin1_General_CP1_CI_AS을 사용하여 만들어집니다.
데이터베이스 데이터 정렬은 만든 후에 수정할 수 없지만 개별 열에 대한 데이터 정렬은 지원됩니다.
패브릭 CLI를 사용하여 데이터베이스를 만들 때 fab api 명령 집합을 사용하여 패브릭 API를 직접 호출할 수 있습니다. 매개 변수에서 원하는 작업 영역, 새 데이터베이스 이름 및 설명 및 원하는 데이터 정렬을 지정합니다.
현재 fab cli 이 명령은 기본이 아닌 데이터 정렬을 사용하여 데이터베이스를 만드는 데 필요합니다. 구문은 다음과 유사합니다.
fab api workspaces/<workspace unique ID>/sqldatabases -X post -H "Content-Type=application/json" -i "{\"displayName\": \"<new database name>\", \"description\": \"<new database description>\", \"creationPayload\":{\"collation\": \"Latin1_General_100_BIN2_UTF8\",\"creationMode\": \"new\"}}"
이 예제에서는 고유한 ID workspace unique ID를 가진 이름 <new database name>, 설명 <new database description>, 데이터 정렬 Latin1_General_100_BIN2_UTF8을 사용하여 작업 영역에 새 데이터베이스를 만듭니다.