mongodrdl

주요 옵션

--help

옵션 및 mongodrdl의 사용에 대한 정보를 반환합니다.

--version

mongodrdl 릴리스 번호를 반환합니다.

--verbose <level>, -v <level>

mongodrdl이 더 자세한 로그 출력을 제공하도록 지정합니다. 보다 자세하게 하려면 여러 번(예: -vvvvv) 포함하거나 숫자 값(예: --verbose=5)을 지정합니다.

--quiet

모든 로그 출력을 숨깁니다.

--uri <mongodb-uri>

버전 2.12의 새로운 기능

MongoDB URI 연결 문자열입니다.

중요

다음 명령줄 옵션은 --uri 옵션과 함께 사용할 수 없습니다.

• --host

• --port

• --db

• --username

• --password (URI 연결 문자열에 비밀번호도 포함된 경우)

• --authenticationDatabase

• --authenticationMechanism

대신 이러한 옵션을 --uri 연결 string 의 일부로 지정합니다.

--host <hostname><:port>, -h <hostname><:port>

기본값: localhost:27017

연결할 mongod 에 대해 확인 가능한 호스트 이름을 지정합니다. 기본값 mongodrdl 는 포트 번호 27017 의 로컬 호스트에서 실행 MongoDB 인스턴스 에 연결을 시도합니다.

복제본 세트에 연결하려면 다음과 같이 replSetName과 세트 멤버의 시드 목록을 지정합니다.

<replSetName>/<hostname1><:port>,<hostname2><:port>,<...>

호스트와 포트 번호를 직접 지정하여 언제든지 단일 MongoDB 인스턴스에 직접 연결할 수 있습니다.

--port <port>

기본값: 27017

MongoDB 인스턴스가 클라이언트 연결 수신을 대기하는 TCP 포트를 지정합니다.

--db <database>, -d <database>

.drdl 스키마 파일을 생성할 데이터베이스를 지정합니다.

--collection <collection>, -c <collection>

.drdl 스키마 파일을 생성할 컬렉션을 지정합니다. 컬렉션을 지정하지 않으면 이 옵션은 지정된 데이터베이스 또는 인스턴스의 모든 컬렉션을 사용합니다.

--customFilterField <name>, -f <name>

사용자 지정 MongoDB 필터에 추가할 필드 이름을 지정합니다. 자세한 내용은 사용자 지정 필터를 참조하세요.

--out <path>, -o <path>

기본값: 표준 아웃.

mongodrdl 이(가) 스키마 파일 을 쓰기 (write) 경로를 지정합니다. 스키마 를 표준 출력으로 보내려면 경로 대신 "-"를 지정합니다.

--sampleSize <size>, -s <size>

기본값: 1000

컬렉션의 스키마를 생성할 때 샘플링할 문서 수를 지정합니다.

--uuidSubtype3Encoding <old|csharp|java>, -b <old|csharp|java>

UUID 바이너리 하위 유형3을 생성하기 위한 인코딩을 지정합니다. 다음 값 중에서 선택합니다.

• old: 이전 BSON 바이너리 하위 유형 표현

• csharp: C#/.NET 레거시 UUID 표현

• java: Java 레거시 UUID 표현

--preJoined

상위 열을 포함하여 언와인딩된 테이블을 생성하여 '사전에 조인된' 테이블을 생성합니다.

--schema <db-id>

버전 2.11에 새로 추가됨.

필수 사항. 스키마 ObjectId의 문자열 표현을 지정합니다.

--name <db-name>

버전 2.11에 새로 추가됨.

스키마 이름을 지정합니다.

중요

사용자 지정 스키마를 업로드하는 경우, 반드시 name-schema를 사용하여 해당 스키마를 지정된 이름으로 저장한 다음 mongosqld에 --schemaName으로 이 이름을 지정해야 합니다. 스키마를 업로드할 때 스키마 이름을 저장하지 않으면 스키마 이름은 defaultSchema로 기본 설정됩니다. 스키마 이름이 존재하지 않는 경우 mongosqld에서 다음과 유사한 오류가 발생합니다. 'MongoDB 스키마를 아직 사용할 수 없습니다. 스키마 초기화 오류: 해당 이름의 스키마를 찾을 수 없습니다.'

--schemaSource <db-name>

버전 2.11에 새로 추가됨.

스키마 정보가 저장되는 데이터베이스 를 지정합니다. 이 옵션은 sample 명령에서 사용되지 않습니다.

TLS/SSL 옵션

--ssl

Default(기본값): False

mongodrdl가 MongoDB 인스턴스에 연결할 때 TLS/SSL을 사용하도록 지시합니다.

--sslCAFile <filename>

인증 기관의 루트 인증서 체인을 포함하는 MongoDB 인스턴스의 .pem 파일을 지정합니다. 상대 경로 또는 절대 경로를 사용해 .pem 파일의 이름을 지정합니다.

경고

mongod 및 mongos 에 대한 SSL 연결( --ssl )의 경우 mongodrdl 가 --sslCAFile 없이 실행되면 mongodrdl 는 서버 인증서의 유효성 검사를 시도하지 않습니다. 이로 인해 만료된 mongod 및 mongos 인증서는 물론 유효한 mongod 또는 mongos 인스턴스로 가장하는 외부 프로세스에 대한 취약성이 발생합니다. 침입 가능성이 있는 경우 서버 인증서의 유효성을 검사하기 위해 항상 CA 파일을 지정해야 합니다.

--sslPEMKeyFile <filename>

MongoDB에 연결할 때 사용할 mongosqld의 TLS/SSL 인증서와 키가 모두 포함된 .pem 파일을 지정합니다. 상대 경로나 절대 경로를 사용하여 .pem 파일의 이름을 지정할 수 있습니다.

이 옵션은 옵션을 사용하여 net.ssl.allowConnectionsWithoutCertificates 없이 --ssl { 가 mongos 활성화된 mongod CAFile또는 에 연결할 때 필요합니다

--sslPEMKeyPassword <password>

MongoDB에 연결하기 위한 인증서와 비공개 키를 포함하는 파일 경로를 지정합니다.

--sslCRLFile <filename>

인증서 해지 목록이 포함된 .pem 파일을 지정합니다. 상대 경로 또는 절대 경로를 .pem 파일의 이름을 지정합니다.

--sslAllowInvalidCertificates

MongoDB 인스턴스가 잘못된 서버 SSL/TLS 인증서를 제시하도록 허용합니다. allowInvalidCertificates 설정을 사용하는 경우, MongoDB는 잘못된 인증서 사용을 경고로 기록합니다.

--sslAllowInvalidHostnames

TLS/SSL 인증서의 호스트 이름 유효성 검사 를 비활성화합니다. 인증서의 호스트 이름이 지정된 호스트 이름과 일치하지 않는 경우 mongodrdl 가 MongoDB 인스턴스에 연결할 수 있도록 허용합니다.

--sslFIPSMode

설치된 OpenSSL 라이브러리의 FIPS 모드 를 사용하도록 mongodrdl 에 지시합니다. --sslFIPSMode 옵션을 사용하려면 시스템에 FIPS를 준수하는 OpenSSL 라이브러리가 있어야 합니다.

--minimumTLSVersion <TLS1_0|TLS1_1|TLS1_2>

기본값: TLS1_1

mongod 또는 mongos 인스턴스에 연결하는 데 필요한 mongodrdl의 최소 TLS 버전을 지정합니다. 기본값 TLS1_1은 TLS 버전 1.1에 해당합니다.

인증 옵션

--username <username>, -u <username>

인증을 사용하는 MongoDB 데이터베이스에 인증하는 데 사용할 사용자 이름을 지정합니다. --password 및 --authenticationDatabase 옵션과 함께 사용합니다.

--password <password>, -p <password>

인증을 사용하는 MongoDB database에 인증하는 데 사용할 비밀번호를 지정합니다. --username 및 --authenticationDatabase 옵션과 함께 사용합니다.

--authenticationDatabase <dbname>

사용자가 생성되는 데이터베이스를 지정합니다. 인증 데이터베이스를 참조하세요.

--authenticationMechanism <name>

기본값: SCRAM-SHA-1

mongodrdl 인스턴스가 mongod 또는 mongos(을)를 인증하는 데 사용하는 인증 메커니즘을 지정합니다.

값	설명
SCRAM-SHA-1	RFC 5802 SHA1 해시 함수를 사용하는 표준 Salted Challenge Response 인증 메커니즘.
SCRAM-SHA-256	버전 2.6에 새로 추가됨 RFC 7677 표준 SHA2 해시 함수를 사용하는 솔티드 챌린지 응답 인증 메커니즘입니다.
PLAIN (LDAP SASL)	LDAP를 사용한 외부 인증. PLAIN 을 사용해 데이터베이스 내 사용자를 인증할 수도 있습니다. PLAIN 은 비밀번호를 일반 텍스트로 전송합니다. 이 메커니즘은 MongoDB Enterprise에서만 사용할 수 있습니다.
GSSAPI (Kerberos)	Kerberos를 사용한 외부 인증. 이 메커니즘은 MongoDB Enterprise에서만 사용할 수 있습니다.

--gssapiServiceName <service-name>

기본값: mongodb

GSSAPI/Kerberos를 사용하여 인증할 때 사용할 서비스 이름입니다.

--gssapiHostName <hostname>

기본값: 원격 서버의 주소

GSSAPI/Kerberos를 사용하여 인증할 때 사용할 호스트 이름입니다.

사용자 지정 필터

BI Connector 는 MongoDB 집계 파이프라인 을 사용하여 MongoDB database 에 대한 쿼리를 수행합니다. 스키마에 특수 필드를 추가하여 사용자 지정 MongoDB $match 쿼리 string 을 MongoDB 인스턴스에 전달할 수 있습니다.

--customFilterField 옵션을 mongodrdl 와 함께 사용하여 사용자 지정 필터 필드의 이름을 지정합니다. 이 필드는 네이티브 MongoDB $match 단계를 전달하여 MongoDB에서 반환된 모든 결과를 필터링하는 집계 파이프라인의 첫 번째 단계로 사용할 수 있습니다. BI Connector는 SQL에서 추가 단계를 푸시하기 전에 이 단계를 적용합니다.

쿼리는 필드가 관계형 스키마에 노출되지 않은 경우에도 컬렉션의 모든 필드를 참조할 수 있습니다.

사용자 지정 필터 사용 예시는 사용자 지정 필터 예시를 참조하세요.

스키마 생성 예시

test 데이터베이스의 abc 컬렉션에 다음과 같은 형태의 문서가 주어집니다:

{
    "_id": ObjectId(),
    "close": 7.45,
    "detail": { "a": 2, "b": 3 }
}

mongodrdl 를 실행하여 이 컬렉션 을 기반으로 스키마 를 생성합니다.

mongodrdl -d test -c abc -o schema.drdl

생성된 스키마 파일(schema.drdl)은 다음과 유사하게 표시됩니다:

schema:
- db: test
  tables:
  - table: abc
    collection: abc
    pipeline: []
    columns:
    - Name: _id
      MongoType: bson.ObjectId
      SqlName: _id
      SqlType: varchar
    - Name: close
      MongoType: float64
      SqlName: close
      SqlType: numeric
    - Name: detail.a
      MongoType: float64
      SqlName: detail.a
      SqlType: numeric
    - Name: detail.b
      MongoType: float64
      SqlName: detail.b
      SqlType: numeric

사용자 지정 필터 예시

이 필드를 사용하려면 이 필드에 사용할 이름과 함께 --customFilterField 플래그를 지정합니다:

mongodrdl [ other options ] --customFilterField _MONGOFILTER -o schema.drdl

DRDL 파일 schema.drdl에는 생성된 모든 테이블에 다음 필드가 포함됩니다:

- Name: _MONGOFILTER
  MongoType: mongo.Filter
  SqlName: _MONGOFILTER
  SqlType: varchar

표준 SQL에 특수 MongoDB 쿼리 단계를 추가하려면 다음 SQL 구문을 사용합니다.

SELECT <normal>
  FROM <tablename>
  WHERE <normal conditions> AND
      _MONGOFILTER='{ <json string that represents query to use> }'
SELECT name,age
  FROM users
  WHERE active='t' AND
      _MONGOFILTER='{"addr":{"$elemMatch":{"city":"Springfield","state":"CA"}}}'

BI Connector는 위의 SQL을 다음과 같은 MongoDB 집계 표현식으로 변환합니다:

db.users.aggregate([
   {$match:{"addr":{"$elemMatch":{"city":"Springfield","state":"CA"}}},
   {$match:{"active":true}},
   {$project:{"name":1, "age":1}}
]);

모든 비즈니스 인텔리전스 도구에서 특수 필드를 필터링하고 일치하는 값을 유효한 JSON을 나타내는 작은따옴표로 묶은 문자열로 제공하면 이 사용자 지정 필터를 사용할 수 있습니다. JSON 내의 모든 따옴표는 큰따옴표로 묶어야 합니다.

인증 예시

인증 이 활성화된 상태에서 MongoDB 서버 를 실행 경우 mongodrdl 명령의 옵션으로 사용자 이름, 비밀번호 및 인증 데이터베이스 를 지정해야 합니다.

.drdl 을 생성하려면 인증 이 활성화된 mongod 인스턴스 에서 파일 을 생성하려면 다음 명령 형식을 사용하세요.

mongodrdl --host myhost.example.net:27017 \
          --username dbUser \
          --password myPassword \
          --db reports \
          --collection FY2017 \
          --authenticationDatabase admin \
          --out schema.drdl