Google은 AI 기술을 사용하여 콘텐츠를 사용자의 기본 언어로 번역합니다. AI 번역에는 오류가 있을 수 있습니다.

MongoSQL

MongoSQL 언어 (MongoSQL 인터페이스 기반)를 사용하여 Looker를 MongoSQL 클러스터에 직접 연결합니다. Looker를 MongoSQL에 연결하면 관계형 SQL 쿼리를 사용하여 문서 데이터를 분석하고 대화형 Looker 대시보드를 빌드할 수 있습니다.

Looker에는 MongoSQL 인터페이스용으로 공식적으로 번들로 제공되는 Apache-2.0 라이선스 JDBC 드라이버가 기본적으로 포함되어 있습니다. 기존 MongoBI 언어와 달리 맞춤 언패키지 JDBC 드라이버 JAR 파일을 수동으로 설치할 필요가 없습니다.

기본 요건 및 MongoSQL 구성

Looker에서 연결을 만들기 전에 MongoSQL에서 다음 구성 단계를 완료하세요.

SQL 스키마 빌더를 사용하여 관계형 스키마 빌드
Atlas IP 액세스 목록에 Looker IP 주소 추가
Looker용 MongoDB 사용자 계정 만들기
Atlas SQL 연결 매개변수 가져오기

SQL 스키마 빌더를 사용하여 관계형 스키마 빌드

MongoDB는 유연한 비관계형 문서 형식 (JSON/BSON)으로 데이터를 저장합니다. Looker가 표준 SQL을 사용하여 MongoDB 컬렉션을 쿼리하려면 먼저 MongoSQL의 SQL 스키마 빌더를 사용하여 SQL 스키마를 구성해야 합니다.

MongoSQL 인터페이스는 SQL 스키마 빌더에서 만든 관계형 스키마를 사용하여 문서 구조, 중첩된 필드, 배열을 표준 SQL 테이블, 행, 열에 매핑합니다. 활성 SQL 스키마가 없으면 SQL 인터페이스에서 MongoDB 컬렉션에 대한 SQL 쿼리를 변환할 수 없습니다.

Looker에서 연결을 만들기 전에 MongoSQL 스키마 빌더 문서를 참고하여 테이블 형식 스키마를 정의하고 게시하세요.

MongoDB Enterprise 온프레미스 인스턴스의 경우 MongoDB SQL 스키마 빌더 CLI를 사용하여 스키마를 정의합니다.

Atlas IP 액세스 목록에 Looker IP 주소 추가

MongoSQL은 클라이언트 연결을 승인된 IP 주소로 제한합니다. Looker 인스턴스에서 MongoSQL을 쿼리하려면 다음 단계에 따라 Looker IP 주소를 Atlas IP 액세스 목록에 추가해야 합니다.

Looker 인스턴스의 리전에 대한 Looker IP 주소 목록을 가져옵니다.
Atlas IP 액세스 목록 문서에 따라 이러한 IP 주소를 Atlas 프로젝트의 IP 액세스 목록에 추가합니다.

Looker용 MongoDB 사용자 계정 만들기

MongoDB Atlas 웹 콘솔을 사용하여 다음 단계에 따라 Looker용 데이터베이스 사용자 계정을 만듭니다.

MongoDB Atlas 콘솔에 로그인합니다.
기본 탐색 메뉴의 보안에서 데이터베이스 액세스를 선택합니다.
새 데이터베이스 사용자 추가 를 클릭합니다.
인증 방법으로 비밀번호 를 선택합니다. 사용자 이름 (예: looker)과 보안 비밀번호를 입력합니다.
데이터베이스 사용자 권한에서 기본 제공 역할을 선택하고 Looker가 액세스할 데이터베이스에 대해 read 역할 (또는 맞춤 읽기 권한)을 할당합니다.
사용자 추가 를 클릭하여 사용자 인증 정보를 저장합니다.

Atlas SQL 연결 매개변수 가져오기

Looker 연결을 만들려면 Atlas SQL 연결의 연결 매개변수를 입력해야 합니다. 다음 단계에 따라 매개변수 정보를 가져올 수 있습니다.

MongoDB Atlas 콘솔에 로그인합니다.
클러스터로 이동하고 연결 을 클릭합니다.
Atlas SQL (또는 SQL을 사용하여 애플리케이션 연결)을 선택합니다.
JDBC 드라이버 를 선택합니다.
생성된 호스트, 포트 (일반적으로 27017), 데이터베이스, SSL 요구사항을 기록해 둡니다. Looker 연결을 만들 때 이러한 세부정보를 입력합니다.

데이터베이스에 대한 Looker 연결 만들기

다음 단계에 따라 Looker에서 MongoSQL로의 연결을 설정합니다.

Looker의 관리 섹션에서 연결을 선택한 후 연결 추가를 클릭합니다.
연결 세부정보를 작성합니다. 대다수의 설정은 대부분의 데이터베이스 언어에 공통적으로 적용됩니다. 자세한 내용은 데이터베이스에 Looker 연결 문서 페이지를 참조하세요. 다음은 일부 설정에 대한 설명입니다. 다른 모든 필드에 기본값을 사용하거나 비워둡니다.
- 이름: 고유한 연결 이름을 입력합니다.
- 언어: 드롭다운 메뉴에서 MongoSQL 을 선택합니다.
- 호스트: MongoSQL 인터페이스에서 제공하는 호스트 이름 (예: <cluster-name>.a.query.mongodb.net).
- 포트: Atlas SQL의 포트 번호 (기본값: 27017).
- 데이터베이스: SQL 스키마 빌더를 사용하여 스키마를 만든 데이터베이스의 이름입니다.
- 사용자 이름: Looker용으로 만든 데이터베이스 사용자 이름입니다.
- 비밀번호: 데이터베이스 사용자 비밀번호입니다.
- SSL: SSL 을 사용 설정합니다 (ssl=true).
- 추가 JDBC 매개변수: (선택사항) MongoDB 드라이버에서 지원하는 추가 JDBC 매개변수(예: authSource=admin 또는 connectTimeoutMS=10000). 지원되는 JDBC 매개변수를 참고하세요.
데이터베이스 연결을 확인하려면 연결 테스트 를 클릭합니다.
Looker에 연결 가능 이 표시되면 연결 을 눌러 연결을 만듭니다.

그러면 데이터베이스 연결이 Looker 연결 관리 페이지의 목록에 추가됩니다.

지원되는 JDBC 매개변수

MongoSQL 언어의 경우 Looker는 추가 JDBC 매개변수 필드에서 다음 JDBC 매개변수를 지원합니다.

appName
authSource
clientinfo
connectTimeoutMS
directConnection
disableclientcache
extjsonmode
heartbeatFrequencyMS
journal
localThresholdMS
maxIdleTimeMS
maxWaitTimeMS
readPreference
replicaSet
retryReads
retryWrites
serverSelectionTimeoutMS
socketTimeoutMS
ssl
tls
tlsAllowInvalidHostnames
tlsInsecure
w
wtimeoutMS

쿼리 제한사항 및 SQL 동작

LookML 모델을 빌드하고 SQL 인터페이스를 사용하여 MongoSQL을 쿼리할 때는 다음 언어 특성을 염두에 두세요.

SQL 스키마 빌더 요구사항: 기본 요건에 설명된 대로 SQL 쿼리에는 Atlas SQL 스키마 빌더에 정의된 사전 구성된 관계형 스키마가 필요합니다.
파생 테이블: 임시 (일반) 파생 테이블은 지원되지만 영구 파생 테이블 (PDT)은 지원되지 않습니다.
날짜 및 타임스탬프 유형: date 데이터 유형은 지원되지 않습니다. 표준 관행은 날짜를 timestamp 필드로 저장하고 모델링하는 것입니다.
시간대: MongoSQL 인터페이스에서 액세스하는 모든 타임스탬프는 UTC로 처리됩니다. Looker는 MongoDB 연결을 위해 데이터베이스 내에서 시간대를 변환하지 않습니다.

기능 지원

Looker가 특정 기능을 지원하려면 데이터베이스 언어도 해당 기능을 지원해야 합니다.

MongoSQL은 Looker 26.16부터 다음 기능을 지원합니다.

기능	지원 여부
Looker (Google Cloud 핵심 서비스)
대칭 집계
파생 테이블
영구 SQL 파생 테이블
영구 기본 파생 테이블
안정적인 뷰
쿼리 종료
SQL 기반 피벗
시간대
SSL
소계
JDBC 추가 파라미터
대소문자 구분
위치 유형
목록 유형
백분위수
고유 백분위수
SQL Runner 표시 프로세스
SQL Runner 설명 테이블
SQL Runner 표시 색인
SQL Runner 선택 10
SQL Runner 카운트
SQL 설명
OAuth 2.0 사용자 인증 정보
컨텍스트 주석
연결 풀링
HLL 스케치
집계 인식
증분 PDT
밀리초
마이크로초
구체화된 뷰
이전 기간 대비 측정항목
대략적인 고유값
데이터베이스 내 분석 모델
맞춤 캘린더