Docs Menu
Docs Home
/
MongoDB Atlas
/ / /

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 Data Federation 시작하기를 참조하세요.

  • 하나 이상의 데이터 저장소에 매핑된 연합 데이터베이스 인스턴스입니다.

    참고

    데이터의 일부 또는 전부를 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).
  • unixODBC 패키지:

    sudo apt install unixodbc
  • ODBINST 패키지:

    sudo apt install odbcinst
  • 배포된 클러스터 및 Atlas Data Federation이 있는 Atlas 계정입니다.

    학습 내용 은 Atlas Data Federation 시작하기를 참조하세요.

  • 하나 이상의 데이터 저장소에 매핑된 연합 데이터베이스 인스턴스입니다.

    참고

    데이터의 일부 또는 전부를 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 기반 도구에 연결할 수 있습니다.

1
2

MongoDB 출시하다 팀 은 모든 소프트웨어 패키지에 디지털 서명을 하여 특정 MongoDB 패키지 가 유효하고 변경되지 않은 MongoDB 출시하다 임을 증명합니다. 다음 단계를 완료하여 SHA256 키와 비교하여 ODBC 운전자 바이너리를 확인합니다.

  1. MongoDB ODBC 드라이버 다운로드 페이지에서 .sha256 Windows x 용 파일 을 다운로드합니다.64

  2. 다음 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 바이너리가 확인된 것입니다.

1

ODBC 드라이버를 설치하려면 다운로드한 설치 파일을 실행하여 Atlas SQL ODBC Setup Wizard(Atlas SQL ODBC 설치 마법사)를 엽니다. 설치 마법사의 단계를 따라 진행합니다.

2

ODBC 연결을 구성하려면 다음과 같이 하세요.

  1. ODBC 데이터 소스 관리자를 엽니다.

    참고

    64비트 프로세서를 사용하는 경우 64비트 ODBC 데이터 소스 관리자를 열어야 합니다.

  2. 시스템 DSN 탭으로 이동합니다.

  3. 시스템 DSN을 추가합니다.

  4. 데이터 소스 의 운전자 를 선택하라는 메시지가 표시되면 MongoDB Atlas SQL ODBC Driver 을(를) 선택합니다.

  5. 연결 정보를 입력합니다. 다음을 입력해야 하세요.

    참고

    Atlas SQL 인터페이스 모달을 사용하여 연결에서 연결 정보를 가져올 수 있습니다.

    필드
    설명
    DSN
    새 DSN의 이름.
    사용자 이름
    데이터베이스에 연결할 때 사용할 데이터베이스 사용자 이름입니다.
    비밀번호
    데이터베이스 사용자의 비밀번호.
    MongoDB URI
    MongoDB deployment URI.
    Database
    연결할 데이터베이스의 이름.
    최대 활성화
    최대 string 길이를 4000 자까지 적용하려면 확인란을 선택하세요. 최대 길이를 알 수 없는 가변 길이 데이터를 지원할 수 없는 MongoDB Server Management Studio와 같은 BI 도구에서 작업하려면 이 옵션을 활성화해야 합니다.Microsoft SQL string
  6. 필수 연결 정보를 입력하면 ODBC 데이터 소스 관리자를 사용하여 연결을 테스트할 수 있습니다.

1

참고

이후 단계에서 서명 파일 의 다운로드 링크를 구성하는 데 필요한 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
2

MongoDB 출시하다 팀 은 모든 소프트웨어 패키지에 디지털 서명을 하여 특정 MongoDB 패키지 가 유효하고 변경되지 않은 MongoDB 출시하다 임을 증명합니다. atlas-sql-odbc.asc 키는 pgp.mongodb.com에서 사용할 수 있습니다.

  1. 다음 명령을 실행하여 .sig 파일 을 다운로드 합니다.

    curl -LO https://translators-connectors-releases.s3.amazonaws.com/mongosql-odbc-driver/ubuntu2204/1.4.0/release/mongoodbc.tar.gz.sig
  2. 다음 명령을 실행하여 키 파일 을 다운로드 한 다음 가져옵니다.

    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
  3. 다음 명령을 실행하여 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
3

다음 예시 에서는 아카이브 콘텐츠를 /usr/local/lib/mongoodbc 로 추출합니다. mongoodbc 디렉토리 에는 LICENSE 파일, README.MD 파일 및 bin 디렉토리 가 포함되어 있습니다. bin 디렉토리 에는 libatsql.so ODBC 운전자 라이브러리가 포함되어 있습니다.

sudo tar -zxf mongoodbc.tar.gz --directory /usr/local/lib
1
  1. 다음 명령을 실행합니다:

    odbcinst -j
  2. DRIVERS, SYSTEM DATA SOURCESUSER 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
2
  1. 원하는 편집기에서 odbcinst.ini 파일 을 엽니다.

    예시:

    sudo vim /etc/odbcinst.ini
  2. 파일 에 다음 항목을 추가하고 libatsql.so ODBC 운전자 라이브러리의 경로를 지정합니다.

    예시:

    [ODBC Drivers]
    MongoDB Atlas SQL ODBC Driver = Installed
    [MongoDB Atlas SQL ODBC Driver]
    Driver=/usr/local/lib/mongoodbc/bin/libatsql.so
3

여러 사용자가 DSN을 주식 하는 경우 시스템 DSN을 구성합니다. 여러 사용자가 DSN을 주식 하지 않아야 하는 경우 사용자 DSN을 구성합니다. 단일 사용자가 DSN을 사용하는 경우 시스템 DSN 또는 사용자 DSN을 구성할 수 있습니다.

  1. 원하는 편집기에서 SYSTEM DATA SOURCES 파일 또는 USER DATA SOURCES 파일 을 엽니다.

    시스템 DSN 예시:

    sudo vim /etc/odbc.ini

    사용자 DSN 예시:

    sudo vim /home/ubuntu/.odbc.ini
  2. 파일에 다음 항목을 추가하고 적절한 값을 지정합니다.

    참고

    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
4

다음 명령을 실행합니다:

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 쿼리 함수를 지원 하지 않습니다.

돌아가기

JDBC 드라이버