영어 버전 문서로 돌아가기Microsoft Azure Cosmos DB 연결
Microsoft Azure Cosmos DB 연결
마지막 업데이트 날짜: 2024년 11월 28일
Microsoft Azure Cosmos DB에서 데이터에 액세스하려면 해당 데이터에 대한 연결 자산을 작성하십시오.
Azure Cosmos DB는 완벽하게 관리되는 NoSQL 데이터베이스 서비스입니다.
Microsoft Azure Cosmos DB에 대한 연결 작성
연결 자산을 작성하려면 다음 연결 세부사항이 필요합니다.
- 호스트 이름
- 포트 번호
- 마스터 키: Azure Cosmos 데이터베이스 기본 읽기-쓰기 키
참고:Entra ID 인증을 위한 전제 조건 :
Microsoft Entra ID는 클라우드 기반 ID 및 액세스 관리 서비스입니다. Entra ID 인증 방법에 대한 연결 값을 얻으려면 Microsoft Azure 포털에 로그인하고 스토리지 계정으로 이동합니다. Microsoft Entra ID에 대한 자세한 내용은 Microsoft Entra ID란 무엇인가요? 를 참조하세요.
Entra ID 클라이언트 시크릿 신임 정보
- 테넌트 ID : Microsoft Entra 테넌트 ID입니다. 테넌트 ID를 찾으려면 다음으로 이동하세요. 마이크로소프트엔트라아이디>속성. 아래로 스크롤하여 테넌트 ID 필드. 자세한 내용은 다음을 참조하세요. Microsoft Entra 테넌트 ID를 찾는 방법.
- 클라이언트 ID: Microsoft Azure 코스모스 DB에 대한 액세스 권한을 부여하기 위한 클라이언트 ID입니다. 애플리케이션의 클라이언트 ID를 찾으려면 다음을 선택하세요. 마이크로소프트 엔트라 아이디. 에서 앱 등록 에서 애플리케이션을 선택하세요. 딸깍 하는 소리 복사 애플리케이션의 클라이언트 ID를 복사합니다. 자세한 내용은 다음을 참조하세요. Microsoft Entra 앱 등록 및 서비스 주체 만들기.
- 클라이언트 비밀: 클라이언트 ID와 연결된 인증 키로, Microsoft Azure Cosmos DB에 대한 액세스 권한 부여를 위한 인증 키입니다. 애플리케이션의 클라이언트 비밀번호를 찾으려면 다음을 선택하세요. 마이크로소프트 엔트라 아이디. 에서 앱 등록 에서 애플리케이션을 선택하세요. 이동 인증서 및 비밀 > 클라이언트 비밀. 딸깍 하는 소리 복사 기존 클라이언트 비밀번호를 복사하거나 새 클라이언트 비밀번호 새 클라이언트 비밀번호를 생성하고 복사합니다. 자세한 내용은 다음을 참조하세요. Microsoft Entra 앱 등록 및 서비스 주체 만들기.
- 스토리지 계정 URL : 스토리지 계정 URL입니다.
Entra ID 사용자 이름 비밀번호 신임 정보
- 클라이언트 ID: 코스모스 DB에 대한 액세스 권한을 부여하기 위한 클라이언트 ID입니다(Microsoft Azure). 애플리케이션의 클라이언트 ID를 찾으려면 다음을 선택하세요. 마이크로소프트 엔트라 아이디. 에서 앱 등록 에서 애플리케이션을 선택하세요. 딸깍 하는 소리 복사 애플리케이션의 클라이언트 ID를 복사합니다. 자세한 내용은 다음을 참조하세요. Microsoft Entra 앱 등록 및 서비스 주체 만들기.
- 사용자 이름 및 비밀번호: Microsoft Azure 코스모스 DB 계정의 사용자 이름 및 비밀번호입니다. 멀티팩터 인증 없이 액세스하려면 권한이 필요합니다.
- 스토리지 계정 URL : 스토리지 계정 URL입니다.
개인 연결의 경우 인터넷에 외부화되지 않은 데이터베이스(예: 방화벽 뒤)에 연결하려면 보안 연결을 설정해야 합니다.
플랫폼에 있는 위치를 기반으로 연결을 작성하는 방법 선택
- 프로젝트에서
- 자산 > 새 자산 > 데이터 소스에 연결을 클릭하십시오. 프로젝트에 연결 추가를 참조하십시오.
- 카탈로그에서
- 카탈로그에 추가 > 연결을 클릭하십시오. 카탈로그에 연결 자산 추가를 참조하십시오.
- 배치 영역에서
- 자산 가져오기 > 데이터 액세스 > 연결을 클릭하십시오. 배치 영역에 데이터 자산 추가를 참조하십시오.
- 플랫폼 자산 카탈로그에서
- 새 연결을 클릭하십시오. 플랫폼 연결 추가를 참조하십시오.
다음 단계: 연결에서 데이터 자산 추가
프로젝트에 있는 연결에서 데이터 추가를 참조하십시오.
카탈로그에 있는 연결에서 데이터 추가를 참조하십시오.
이 연결의 사용처
다음 작업 공간 및 도구에서 Microsoft Azure Cosmos DB 연결을 사용할 수 있습니다.
프로젝트
- Data Refinery (watsonx.ai Studio 또는 ' IBM Knowledge Catalog' )
- DataStage (DataStage 서비스). DataStage의 데이터 소스에 연결을 참조하십시오.
- Decision Optimizationwatsonx.ai 스튜디오 및 watsonx.ai 런타임)
- 노트북watsonx.ai Studio). 코드 스니펫 분할창에서 데이터 읽기 를 클릭하여 연결 신임 정보를 가져오고 데이터를 데이터 구조에 로드하십시오. 데이터 소스 연결에서 데이터 로드를 참조하십시오.
- SPSS Modeler (watsonx.ai Studio)
Catalogs
Platform assets catalog
기타 카탈로그(IBM Knowledge Catalog )
Azure Cosmos DB 설정
제한사항
- 코어(SQL) API만 지원됩니다.
- Azure Cosmos DB 연결로 인증에 Entra ID 자격 증명을 사용하는 경우 컬렉션/컨테이너를 만들거나 삭제하는 것은 지원되지 않습니다. 기존 컬렉션을 나열하고 변경하는 것만 지원됩니다. 자세한 내용은 Azure Cosmos DB 문서를 참조하세요.
SQL문 실행
SQL문이 올바르게 실행되는지 확인하려면 Azure Cosmos DB 문서 에서 올바른 구문을 참조하십시오.
자세한 정보
상위 주제: 지원되는 연결