システム変数

項目一覧

Overview

システム変数の設定

Overview

BI Connector は、次の環境変数を提供します。

システム変数	データ型	説明	デフォルト値
`full_pushdown_exec_mode`	ブール値	MongoDB 問い合わせ言語に完全に変換されていない句を持つクエリに対してクエリエラーを返すかどうかを指定します。 SQL クエリ述語は、クエリによって返されるデータをフィルタリングするために使用されます。	`0 (false)`
`log_level`	integer	BI Connector のログレベルを指定します。 `-1`: ログに記録しないでください。 `0`: 基本的な`mongosqld`イベントや状態の変更など、データベースユーザーのメッセージのみをログに記録します。 `1`: データベースユーザーと`mongosqld`管理者のログメッセージ。 `2`: 内部でのみ使用します。	`2 (Atlas-hosted) and 0 (self-managed)`
`max_nested_table_depth`	integer	`mongosqld`がコレクションの関係テーブルにマッピングする一意のネストされたフィールドパスの最大数を指定します。	`50`
`max_num_global_tables`	integer	自動生成スキーマを使用した MongoDB 配置で許可されるテーブルの最大数。	`4000`
`max_num_tables_per_collection`	integer	自動生成されたスキーマを持つテーブル内のコレクション内で許可されるテーブルの最大数。	`200`
`max_nested_table_depth`	integer	MongoDB がテーブルに変換する配列の、テーブルのネスト深度のデフォルト制限。自動生成されたスキーマを持つコレクション内の、	`10`
`max_num_fields_per_collection`	integer	自動生成されたスキーマを持つテーブル内のコレクションごとに検査されるフィールドの最大数。	`2000`
`mongodb_max_varchar_length`	integer	`VARCHAR` データ型を使用する列に返される最大stringの長さを指定します。 `0`の値は制限を指定しません。	`0`
`polymorphic_type_conversion_mode`	string	BI Connector が複数のデータ型で指定されたドキュメントフィールドを評価する方法を決定します。たとえば、 `count`は、あるドキュメントでは数値、別のドキュメントでは string の場合があります。 BI Connector が選択するデータ型は、 `schema_mapping_mode`システム変数の値によって異なります。 `majority`の値により、BI Connector はドキュメントフィールドの大部分に表示される型を選択し、 `lattice`の値により、BI Connector は`count`のデータ型として string を選択します。詳細については、「キャッシュされたサンプリング」を参照してください。 `polymorphic_type_conversion_mode`を次のいずれかの値に設定します。 `off`: 複数のデータ型で指定されたドキュメントフィールドを明示的にキャストしないと、クエリが失敗する可能性があります。 `fast`: BI Connector は、サンプリング中に複数のデータ型として表示されたドキュメントフィールドのみを変換します。 `safe`: BI Connector は、フィールドが複数のデータ型として表示されない場合でも、すべてのドキュメントフィールドをサンプリング中に検出されたデータ型に変換します。	`off`
`reconcile_arithmetic_agg_functions`	ブール値	MongoDB が算術集計関数を使用して一部のクエリの型を自動的に変換しない動作を選択できます。 MongoDB バージョン 3.6 以前では、この動作は、後続のバージョンの算術集計関数の暗黙の型変換と比較して、パフォーマンスが向上します。詳細については、「タイプ変換モード」を参照してください。	`true`
`sample_refresh_interval_secs`	integer	BI Connector スキーマを更新する頻度を秒単位で指定します。値が`0`の場合、BI Connector の起動後にスキーマが更新されないことを指定します。詳細については、「キャッシュされたサンプリング」を参照してください。	`0`
`sample_size`	integer	スキーマを生成するときに BI Connector がサンプリングするドキュメントの数を指定します。 `0`の値は、BI Connector がすべてのサンプル`namespaces`にわたってコレクションスキャンを実行することを指定します。詳細については、「キャッシュされたサンプリング」を参照してください。	`100`
`schema_mapping_mode`	string	MongoDB スキーマをリレーショナルスキーマに変換する方法を指定します。 `lattice`: 詳細については、「サンプリング型の競合」を参照してください。 `majority`: BI Connector は、サンプル内の発生するフィールドに最も一般的なデータ型を割り当てます。	`lattice`
`type_conversion_mode`	string	BI Connector がタイプ変換に使用するセマンティクスを指定します`CAST`関数など）。 `mysql` `mongosql`	`mongosql`

システム変数の設定

Atlas でホストされる BI Connector で環境変数を設定するには、 atlasAdminデータベースロールが必要です。自己管理型 BI Connector にこの値を設定するには、BI Connector を接続した MongoDB database に対するinprog特権が必要です。

BI Connector に接続されている SQL クライアントを使用して、これらの変数を設定します。次の例では、 mongodb_max_varchar_lengthを100に設定します。

SET GLOBAL mongodb_max_varchar_length = 100

システム変数を設定した後、BI Connector への新しい接続を開始する必要があります。システム変数の設定に使用した接続は影響を受けません。

戻る

ユーザー認証モデル

MongoDB Connector for BI の既知の問題