ODBC 드라이버를 사용하여 아틀라스 SQL에 연결
이 페이지의 내용
이 페이지에서는 연합 데이터베이스 인스턴스에 연결하기 위해 MongoDB ODBC 드라이버를 설치 및 구성하는 방법을 설명합니다.
현재 ODBC 드라이버는 다음 아키텍처에서 사용할 수 있습니다.
Windows
Ubuntu 22.04 (x86_64)
지원되는 인증 메커니즘
SCRAM-SHA-1, SCRAM-SHA-256, MONGODB-X509, AWS를 통한 MongoDB 암호 없는 인증을 사용해 인증할 수 있습니다.
전제 조건
배포된 클러스터 및 Atlas Data Federation이 있는 Atlas 계정입니다.
하나 이상의 데이터 저장소에 매핑된 연합 데이터베이스 인스턴스입니다.
참고
데이터의 일부 또는 전부를 Atlas 클러스터에서 가져오는 경우, 해당 클러스터에서 Atlas SQL을 활용하려면 MongoDB 버전 5.0 이상을 사용해야 합니다.
ODBC 드라이버를 사용하여 연합 데이터베이스 인스턴스에 연결하려는 애플리케이션 또는 BI 도구입니다.
Microsoft Visual C++ Redistributable 17.0 Microsoft C 및 C++ (MSVC) 런타임 라이브러리를 설치하려면 이상입니다.
참고
C++ 런타임 라이브러리가 설치되지 않은 경우 ODBC 드라이버는 다음 오류를 반환합니다.
The specified module could not be found (path of the dll which exists and has the proper permission).
배포된 클러스터 및 Atlas Data Federation이 있는 Atlas 계정입니다.
하나 이상의 데이터 저장소에 매핑된 연합 데이터베이스 인스턴스입니다.
참고
데이터의 일부 또는 전부를 Atlas 클러스터에서 가져오는 경우, 해당 클러스터에서 Atlas SQL을 활용하려면 MongoDB 버전 5.0 이상을 사용해야 합니다.
ODBC 드라이버를 사용하여 연합 데이터베이스 인스턴스에 연결하려는 애플리케이션 또는 BI 도구입니다.
Microsoft Visual C++ Redistributable 17.0 Microsoft C 및 C++ (MSVC) 런타임 라이브러리를 설치하려면 이상입니다.
참고
C++ 런타임 라이브러리가 설치되지 않은 경우 ODBC 드라이버는 다음 오류를 반환합니다.
The specified module could not be found (path of the dll which exists and has the proper permission).
절차
ODBC 드라이버를 사용하여 ODBC API를 허용하는 SQL 기반 도구에 연결할 수 있습니다.
ODBC 드라이버 다운로드
MongoDB 다운로드 센터에서 최신 MongoDB ODBC 드라이버 버전을 다운로드합니다.
다운로드한 패키지 의 무결성을 확인합니다.
MongoDB 출시하다 팀 은 모든 소프트웨어 패키지에 디지털 서명을 하여 특정 MongoDB 패키지 가 유효하고 변경되지 않은 MongoDB 출시하다 임을 증명합니다. 다음 단계를 완료하여 SHA256 키와 비교하여 ODBC 운전자 바이너리를 확인합니다.
MongoDB ODBC 드라이버 다운로드 페이지에서
.sha256
Windows x 용 파일 을 다운로드합니다.64다음 Powershell 스크립트 를 사용하여 서명 파일 을 MongoDB 설치 프로그램 해시와 비교합니다.
sigHash = (Get-Content $Env:HomePath\Downloads\mongodbodbc.msi.sha256 | Out-String). SubString(0,64).ToUpper(); ` fileHash = (Get-FileHash $Env:HomePath\Downloads\mongodbodbc.msi).Hash.Trim(); ` echo $sigHash; echo $fileHash; ` sigHash -eq $fileHash 이 명령은 세 줄을 출력합니다.
MongoDB 에서 직접 다운로드한 SHA256 해시입니다.
MongoDB 에서 다운로드한 MongoDB ODBC 운전자 바이너리에서 계산된 SHA256 해시입니다.
해시가 일치하는지 여부에 따라 True 또는 False 결과가 반환됩니다.
해시가 일치하면 MongoDB 바이너리가 확인된 것입니다.
ODBC 드라이버 설치 및 구성
시스템 DSN을 구성합니다.
ODBC 연결을 구성하려면 다음과 같이 하세요.
ODBC 데이터 소스 관리자를 엽니다.
참고
64비트 프로세서를 사용하는 경우 64비트 ODBC 데이터 소스 관리자를 열어야 합니다.
시스템 DSN 탭으로 이동합니다.
새 시스템 DSN을 추가합니다.
데이터 소스 의 운전자 를 선택하라는 메시지가 표시되면 MongoDB Atlas SQL ODBC Driver 을(를) 선택합니다.
연결 정보를 입력합니다. 다음을 입력해야 하세요.
참고
Atlas SQL 인터페이스 모달을 사용하여 연결에서 연결 정보를 가져올 수 있습니다.
필드설명DSN새 DSN의 이름.사용자 이름데이터베이스에 연결할 때 사용할 데이터베이스 사용자 이름입니다.비밀번호데이터베이스 사용자의 비밀번호.MongoDB URIMongoDB deployment URI.Database연결할 데이터베이스의 이름.최대 활성화최대 string 길이를 4000 자까지 적용하려면 확인란을 선택하세요. 최대 길이를 알 수 없는 가변 길이 데이터를 지원할 수 없는 MongoDB Server Management Studio와 같은 BI 도구에서 작업하려면 이 옵션을 활성화해야 합니다.Microsoft SQL string필수 연결 정보를 입력하면 ODBC 데이터 소스 관리자를 사용하여 연결을 테스트할 수 있습니다.
ODBC 드라이버 다운로드 및 확인
MongoDB ODBC 드라이버 를 다운로드합니다.
참고
이후 단계에서 서명 파일 의 다운로드 링크를 구성하는 데 필요한 URL 을 저장하려면 Copy link 을 클릭합니다.
curl https://translators-connectors-releases.s3.amazonaws.com/mongosql-odbc-driver/ubuntu2204/1.4.0/release/mongoodbc.tar.gz --output mongoodbc.tar.gz
다운로드한 패키지의 무결성을 확인합니다.
MongoDB 출시하다 팀 은 모든 소프트웨어 패키지에 디지털 서명을 하여 특정 MongoDB 패키지 가 유효하고 변경되지 않은 MongoDB 출시하다 임을 증명합니다. atlas-sql-odbc.asc
키는 pgp.mongodb.com에서 사용할 수 있습니다.
다음 명령을 실행하여
.sig
파일 을 다운로드 합니다.curl -LO https://translators-connectors-releases.s3.amazonaws.com/mongosql-odbc-driver/ubuntu2204/1.4.0/release/mongoodbc.tar.gz.sig 다음 명령을 실행하여 키 파일 을 다운로드 한 다음 가져옵니다.
curl -LO https://pgp.mongodb.com/atlas-sql-odbc.asc gpg --import atlas-sql-odbc.asc gpg: key 1CCF1A1263CDD699: public key "Atlas SQL ODBC Release Signing Key <packaging@mongodb.com>" imported gpg: Total number processed: 1 gpg: imported: 1 다음 명령을 실행하여 MongoDB 설치 파일 을 확인합니다.
gpg --verify mongoodbc.tar.gz.sig mongoodbc.tar.gz GPG는 이 응답을 반환해야 합니다.
gpg: Signature made Wed May 22 13:24:36 2024 MDT gpg: using RSA key 0C5F007ABC491E4A gpg: Good signature from "Atlas SQL ODBC Release Signing Key <packaging@mongodb.com>" [unknown] 패키지가 올바르게 서명되었지만 현재 로컬
trustdb
의 서명 키를 신뢰하지 않는 경우gpg
가 아래 메시지도 반환합니다.gpg: WARNING: This key is not certified with a trusted signature! gpg: There is no indication that the signature belongs to the owner. Primary key fingerprint: 1CF5 B0D7 B2F8 9E16 52D8 BA79 0C5F 007A BC49 1E4A 다음과 같은 오류 메시지가 나타나면 올바른 공개 키를 가져왔는지 확인합니다.
gpg: Can't check signature: public key not found
ODBC 드라이버 설치 및 구성
ODBC 운전자 구성 파일을 찾습니다.
다음 명령을 실행합니다:
odbcinst -j DRIVERS
,SYSTEM DATA SOURCES
및USER DATA SOURCES
에 대한 구성 파일의 위치를 확인합니다.예시:
unixODBC 2.3.9 DRIVERS............: /etc/odbcinst.ini SYSTEM DATA SOURCES: /etc/odbc.ini FILE DATA SOURCES..: /etc/ODBCDataSources USER DATA SOURCES..: /home/ubuntu/.odbc.ini SQLULEN Size.......: 8 SQLLEN Size........: 8 SQLSETPOSIROW Size.: 8
시스템 DSN 또는 사용자 DSN을 구성합니다.
여러 사용자가 DSN을 주식 하는 경우 시스템 DSN을 구성합니다. 여러 사용자가 DSN을 주식 하지 않아야 하는 경우 사용자 DSN을 구성합니다. 단일 사용자가 DSN을 사용하는 경우 시스템 DSN 또는 사용자 DSN을 구성할 수 있습니다.
원하는 편집기에서
SYSTEM DATA SOURCES
파일 또는USER DATA SOURCES
파일 을 엽니다.시스템 DSN 예시:
sudo vim /etc/odbc.ini 사용자 DSN 예시:
sudo vim /home/ubuntu/.odbc.ini 파일에 다음 항목을 추가하고 적절한 값을 지정합니다.
참고
Atlas SQL 인터페이스 모달을 사용하여 연결에서 연결 정보를 가져올 수 있습니다.
필드설명Password
데이터베이스 사용자의 비밀번호입니다.Driver
libatsql.so
ODBC 운전자 라이브러리의 경로입니다.Database
연결할 데이터베이스 의 이름입니다.User
데이터베이스에 연결하는 데 사용할 데이터베이스 사용자 이름 입니다.Uri
MongoDB deployment URI.UnicodeTranslationOption
Atlas SQL 용 유니코드 인코딩.utf16
으로 설정합니다.enable_max_string_length
선택 사항. 4000 자의 최대 string 길이를 시행하다 플래그입니다. 활성화 하려면 값을1
로 설정하다 하고 비활성화하려면 값을0
로 설정하다 합니다. 생략하면 기본값은0
입니다. 최대 길이를 알 수 없는 가변 길이 데이터를 지원 수 없는 Server Management Studio와 같은 BI 도구에서 작업하려면 이 옵션을 활성화 해야 합니다.Microsoft SQL string예시:
[ODBC Data Sources] MongoDB_Atlas_SQL = "MongoDB Atlas SQL ODBC Driver" [MongoDB_Atlas_SQL] Password = your_password Driver = /usr/local/lib/mongoodbc/bin/libatsql.so Database = sample_mflix User = your_username Uri = mongodb://datalake.region.a.query.mongodb.net/?ssl=true UnicodeTranslationOption = utf16
연결을 테스트합니다.
다음 명령을 실행합니다:
iusql -v MongoDB_Atlas_SQL
다음 예시 는 성공적인 연결을 보여줍니다.
+---------------------------------------+ | Connected! | | | | sql-statement | | help [tablename] | | quit | | | +---------------------------------------+
연결에 실패하면 Atlas Data Federation 인스턴스 를 비교하여 구성 파일의 세부 정보를 확인하세요.
참고
다음 경고는 ODBC 운전자 작업에 영향 을 주지 않습니다.
[MongoDB][API] Buffer size "0" not large enough for data.
ODBC 운전자 가 iusql
쿼리 함수를 지원 하지 않습니다.