CData Cloud は、クラウドホスト型のソリューションで、複数の標準サービスやプロトコルにまたがるOdoo へのアクセスを実現します。MySQL またはSQL Server データベースに接続できるアプリケーションであれば、CData Cloud を介してOdoo に接続できます。
CData Cloud により、他のOData エンドポイントや標準SQL Server / MySQL データベースと同じように、Odoo への接続を標準化し、構成することができます。
このページでは、CData Cloud でのOdoo への接続の確立 のガイド、利用可能なリソースに関する情報、および使用可能な接続プロパティのリファレンスについて説明します。
接続の確立 は、CData Cloud にデータベースを作成するためのOdoo への認証方法と必要な接続プロパティの設定方法について示します。
利用可能な標準サービスを経由してOdoo からデータにアクセスする方法と、CData Cloud の管理については、CData Cloud ドキュメント で詳しく説明します。
Database タブで対応するアイコンを選択して、Odoo に接続します。必須プロパティはSettings にリストされています。Advanced タブには、通常は必要ない接続プロパティが表示されます。
API トークンを使用していない場合は(API トークンはOdoo 14以上でのみサポートされています)、APIToken フィールドにパスワードを入力することも可能です。
この変更を行うことができない場合は、rpCheckPermissions オプションをfalse に設定する必要があります。これにより、ユーザーが実際にそれらのモデルに対して持っている権限にかかわらず、Odoo のすべてのモデルがテーブルとしてリストされます。
デフォルトでは、Cloud はサーバーの証明書をシステムの信頼できる証明書ストアと照合してSSL / TLS のネゴシエーションを試みます。
別の証明書を指定するには、利用可能なフォーマットについてSSLServerCert プロパティを参照してください。
Windows のシステムプロキシ経由の接続では、接続プロパティを追加で設定する必要はありません。他のプロキシに接続するには、ProxyAutoDetect をfalse に設定します。
さらにHTTP プロキシへの認証には、ProxyServer とProxyPort に加えてProxyAuthScheme、ProxyUser、およびProxyPassword を設定します。
次のプロパティを設定します。
Cloud は Odoo モデルをリレーショナルテーブルおよびビューとして表示します。テーブル定義は、接続先のOdoo サイトから動的に取得されます。実際に利用可能なものは、インストールしたアプリに応じて異なります。ここにリストされているテーブルは例です。実際に利用可能なものとは異なる場合があります。
接続する際、Cloud はどのモデルを変更できるか、どのモデルが読み取り専用かを決定します。変更が可能なモデルはテーブルとして表示され、データの読み出し、挿入、更新、および削除がサポートされています。
読み取り専用のモデルはビューとして表示されます。テーブルと同じようにデータを読み出すことができますが、挿入、更新、削除は許可されていません。
Odoo の中には、テキストや日付などの単純な値を持つカラムに加え、各行に複数の値を含むカラムもあります。Cloud は、値があるカラムの種類に応じて、これらの種類の値を異なる方法でデコードします。
例えば、Calendar モジュールには"calendar_event" というイベントのモデルが含まれています。このモデルには、"crm_lead" モデルの商談を参照する"opportunity_id" というカラムがあります。カレンダーイベントを作成または更新するときは、opportunity_id をミーティングを行うリードのID に設定できます。
INSERT INTO calendar_event (name, start, stop, opportunity_id) VALUES ('Meet With Potential Customer', '...', '...', 42)
このイベントを後で読む場合、opportunity_id の値は42 となります。
例えば、Calendar モジュールには"calendar_event" というイベントのモデルが含まれています。このモデルには、"res_partner" モデルの連絡先を参照する"partner_ids" というカラムがあります。カレンダーイベントを作成または更新するときは、partner_ids をミーティングの出席者のID に設定できます。
INSERT INTO calendar_event (name, start, stop, partner_ids) VALUES ('Meet With Potential Customer', '...', '...', '13,57')
このイベントを後で読む場合、partner_ids の値はテキスト"13,57"(もしくは、ID は順不同のため"57,13")となります。
例えば、Calendar モジュールには"calendar_event" というイベントのモデルが含まれています。このモデルには、"event_attendee" モデルに格納されている会議出席依頼を参照する"attendee_ids" というカラムがあります。partner_ids とは異なり、異なるミーティングで同じパートナーを共有でき、異なるパートナーが同じミーティングに参加できる場合、各出席依頼は1つのイベントにのみリンクされます。
現在、これらのカラムはMany2Many カラムと同じように(カンマ区切りのID リストを含むテキストとして)読み出されますが、書き込むことはできません。
ビューは、データを示すという点でテーブルに似ていますが、ビューは読み取り専用です。
クエリは、ビューに対して通常のテーブルと同様に実行することができます。
Name | Description |
FieldReferences | Retrieves both single-value and multi-value references from a table. |
Retrieves both single-value and multi-value references from a table.
Name | Type | References | Description |
ReferenceTable | String | The name of the table containing the reference field. | |
ReferenceColumn | String | The name of column that refers to another field. | |
TargetTable | String | The name of the table targetted by the reference. | |
IsMultiValued | Boolean | Whether the reference column contains multiple values. |
ストアドプロシージャはファンクションライクなインターフェースで、Odoo の単純なSELECT/INSERT/UPDATE/DELETE 処理にとどまらずCloud の機能を拡張します。
ストアドプロシージャは、パラメータのリストを受け取り、目的の機能を実行し、プロシージャが成功したか失敗したかを示すとともにOdoo から関連するレスポンスデータを返します。
Name | Description |
CallProcedure | Calls a server-side RPC within Odoo. |
Calls a server-side RPC within Odoo.
Name | Type | Description |
Model | String | The model to execute the procedure on. |
Operation | String | The procedure to execute. |
Arguments | String | The list of arguments to pass to the RPC, formatted as a JSON list |
KeywordArgs | String | The keyword arguments to pass to the RPC, formatted as a JSON object |
Name | Type | Description |
JSON | String | The output of the RPC converted to JSON. |
このセクションで説明されているシステムテーブルをクエリして、スキーマ情報、データソース機能に関する情報、およびバッチ操作の統計にアクセスできます。
以下のテーブルは、Odoo のデータベースメタデータを返します。
以下のテーブルは、データソースへの接続方法およびクエリ方法についての情報を返します。
次のテーブルは、データ変更クエリのクエリ統計を返します。
利用可能なデータベースをリストします。
次のクエリは、接続文字列で決定されるすべてのデータベースを取得します。
SELECT * FROM sys_catalogs
Name | Type | Description |
CatalogName | String | データベース名。 |
利用可能なスキーマをリストします。
次のクエリは、すべての利用可能なスキーマを取得します。
SELECT * FROM sys_schemas
Name | Type | Description |
CatalogName | String | データベース名。 |
SchemaName | String | スキーマ名。 |
利用可能なテーブルをリストします。
次のクエリは、利用可能なテーブルおよびビューを取得します。
SELECT * FROM sys_tables
Name | Type | Description |
CatalogName | String | テーブルまたはビューを含むデータベース。 |
SchemaName | String | テーブルまたはビューを含むスキーマ。 |
TableName | String | テーブル名またはビュー名。 |
TableType | String | テーブルの種類(テーブルまたはビュー)。 |
Description | String | テーブルまたはビューの説明。 |
IsUpdateable | Boolean | テーブルが更新可能かどうか。 |
利用可能なテーブルおよびビューのカラムについて説明します。
次のクエリは、res_users テーブルのカラムとデータ型を返します。
SELECT ColumnName, DataTypeName FROM sys_tablecolumns WHERE TableName='res_users'
Name | Type | Description |
CatalogName | String | テーブルまたはビューを含むデータベースの名前。 |
SchemaName | String | テーブルまたはビューを含むスキーマ。 |
TableName | String | カラムを含むテーブルまたはビューの名前。 |
ColumnName | String | カラム名。 |
DataTypeName | String | データ型の名前。 |
DataType | Int32 | データ型を示す整数値。この値は、実行時に環境に基づいて決定されます。 |
Length | Int32 | カラムのストレージサイズ。 |
DisplaySize | Int32 | 指定されたカラムの通常の最大幅(文字数)。 |
NumericPrecision | Int32 | 数値データの最大桁数。文字データおよび日時データの場合は、カラムの長さ(文字数)。 |
NumericScale | Int32 | カラムのスケール(小数点以下の桁数)。 |
IsNullable | Boolean | カラムがNull を含められるかどうか。 |
Description | String | カラムの簡単な説明。 |
Ordinal | Int32 | カラムのシーケンスナンバー。 |
IsAutoIncrement | String | カラムに固定増分値が割り当てられるかどうか。 |
IsGeneratedColumn | String | 生成されたカラムであるかどうか。 |
IsHidden | Boolean | カラムが非表示かどうか。 |
IsArray | Boolean | カラムが配列かどうか。 |
IsReadOnly | Boolean | カラムが読み取り専用かどうか。 |
IsKey | Boolean | sys_tablecolumns から返されたフィールドがテーブルの主キーであるかどうか。 |
利用可能なストアドプロシージャをリストします。
次のクエリは、利用可能なストアドプロシージャを取得します。
SELECT * FROM sys_procedures
Name | Type | Description |
CatalogName | String | ストアドプロシージャを含むデータベース。 |
SchemaName | String | ストアドプロシージャを含むスキーマ。 |
ProcedureName | String | ストアドプロシージャの名前。 |
Description | String | ストアドプロシージャの説明。 |
ProcedureType | String | PROCEDURE やFUNCTION などのプロシージャのタイプ。 |
ストアドプロシージャパラメータについて説明します。
次のクエリは、CallProcedure ストアドプロシージャのすべての入力パラメータについての情報を返します。
SELECT * FROM sys_procedureparameters WHERE ProcedureName='CallProcedure' AND Direction=1 OR Direction=2
Name | Type | Description |
CatalogName | String | ストアドプロシージャを含むデータベースの名前。 |
SchemaName | String | ストアドプロシージャを含むスキーマの名前。 |
ProcedureName | String | パラメータを含むストアドプロシージャの名前。 |
ColumnName | String | ストアドプロシージャパラメータの名前。 |
Direction | Int32 | パラメータのタイプに対応する整数値:input (1)。input/output (2)、またはoutput(4)。input/output タイプパラメータは、入力パラメータと出力パラメータの両方になれます。 |
DataTypeName | String | データ型の名前。 |
DataType | Int32 | データ型を示す整数値。この値は、実行時に環境に基づいて決定されます。 |
Length | Int32 | 文字データの場合は、許可される文字数。数値データの場合は、許可される桁数。 |
NumericPrecision | Int32 | 数値データの場合は最大精度。文字データおよび日時データの場合は、カラムの長さ(文字数)。 |
NumericScale | Int32 | 数値データの小数点以下の桁数。 |
IsNullable | Boolean | パラメータがNull を含められるかどうか。 |
IsRequired | Boolean | プロシージャの実行にパラメータが必要かどうか。 |
IsArray | Boolean | パラメータが配列かどうか。 |
Description | String | パラメータの説明。 |
Ordinal | Int32 | パラメータのインデックス。 |
主キーおよび外部キーについて説明します。
次のクエリは、res_users テーブルの主キーを取得します。
SELECT * FROM sys_keycolumns WHERE IsKey='True' AND TableName='res_users'
Name | Type | Description |
CatalogName | String | キーを含むデータベースの名前。 |
SchemaName | String | キーを含むスキーマの名前。 |
TableName | String | キーを含むテーブルの名前。 |
ColumnName | String | キーカラムの名前 |
IsKey | Boolean | カラムがTableName フィールドで参照されるテーブル内の主キーかどうか。 |
IsForeignKey | Boolean | カラムがTableName フィールドで参照される外部キーかどうか。 |
PrimaryKeyName | String | 主キーの名前。 |
ForeignKeyName | String | 外部キーの名前。 |
ReferencedCatalogName | String | 主キーを含むデータベース。 |
ReferencedSchemaName | String | 主キーを含むスキーマ。 |
ReferencedTableName | String | 主キーを含むテーブル。 |
ReferencedColumnName | String | 主キーのカラム名。 |
外部キーについて説明します。
次のクエリは、他のテーブルを参照するすべての外部キーを取得します。
SELECT * FROM sys_foreignkeys WHERE ForeignKeyType = 'FOREIGNKEY_TYPE_IMPORT'
名前 | タイプ | 説明 |
CatalogName | String | キーを含むデータベースの名前。 |
SchemaName | String | キーを含むスキーマの名前。 |
TableName | String | キーを含むテーブルの名前。 |
ColumnName | String | キーカラムの名前 |
PrimaryKeyName | String | 主キーの名前。 |
ForeignKeyName | String | 外部キーの名前。 |
ReferencedCatalogName | String | 主キーを含むデータベース。 |
ReferencedSchemaName | String | 主キーを含むスキーマ。 |
ReferencedTableName | String | 主キーを含むテーブル。 |
ReferencedColumnName | String | 主キーのカラム名。 |
ForeignKeyType | String | 外部キーがインポート(他のテーブルを指す)キーかエクスポート(他のテーブルから参照される)キーかを指定します。 |
主キーについて説明します。
次のクエリは、すべてのテーブルとビューから主キーを取得します。
SELECT * FROM sys_primarykeys
Name | Type | Description |
CatalogName | String | キーを含むデータベースの名前。 |
SchemaName | String | キーを含むスキーマの名前。 |
TableName | String | キーを含むテーブルの名前。 |
ColumnName | String | キーカラムの名前。 |
KeySeq | String | 主キーのシーケンス番号。 |
KeyName | String | 主キーの名前。 |
利用可能なインデックスについて説明します。インデックスをフィルタリングすることで、より高速なクエリ応答時間でセレクティブクエリを記述できます。
次のクエリは、主キーでないすべてのインデックスを取得します。
SELECT * FROM sys_indexes WHERE IsPrimary='false'
Name | Type | Description |
CatalogName | String | インデックスを含むデータベースの名前。 |
SchemaName | String | インデックスを含むスキーマの名前。 |
TableName | String | インデックスを含むテーブルの名前。 |
IndexName | String | インデックス名。 |
ColumnName | String | インデックスに関連付けられたカラムの名前。 |
IsUnique | Boolean | インデックスが固有の場合はTrue。そうでない場合はFalse。 |
IsPrimary | Boolean | インデックスが主キーの場合はTrue。そうでない場合はFalse。 |
Type | Int16 | インデックスタイプに対応する整数値:statistic (0)、clustered (1)、hashed (2)、またはother (3)。 |
SortOrder | String | 並べ替え順序:A が昇順、D が降順。 |
OrdinalPosition | Int16 | インデックスのカラムのシーケンスナンバー。 |
利用可能な接続プロパティと、接続文字列に設定されている接続プロパティに関する情報を返します。
このテーブルをクエリする際は、config 接続文字列を使用する必要があります。
jdbc:cdata:odoo:config:
この接続文字列を使用すると、有効な接続がなくてもこのテーブルをクエリできます。
次のクエリは、接続文字列に設定されている、あるいはデフォルト値で設定されているすべての接続プロパティを取得します。
SELECT * FROM sys_connection_props WHERE Value <> ''
Name | Type | Description |
Name | String | 接続プロパティ名。 |
ShortDescription | String | 簡単な説明。 |
Type | String | 接続プロパティのデータ型。 |
Default | String | 明示的に設定されていない場合のデフォルト値。 |
Values | String | 可能な値のカンマ区切りリスト。別な値が指定されていると、検証エラーがスローされます。 |
Value | String | 設定した値またはあらかじめ設定されたデフォルト。 |
Required | Boolean | プロパティが接続に必要かどうか。 |
Category | String | 接続プロパティのカテゴリ。 |
IsSessionProperty | String | プロパティが、現在の接続に関する情報を保存するために使用されるセッションプロパティかどうか。 |
Sensitivity | String | プロパティの機密度。これは、プロパティがロギングおよび認証フォームで難読化されているかどうかを通知します。 |
PropertyName | String | キャメルケースの短縮形の接続プロパティ名。 |
Ordinal | Int32 | パラメータのインデックス。 |
CatOrdinal | Int32 | パラメータカテゴリのインデックス。 |
Hierarchy | String | このプロパティと一緒に設定する必要がある、関連のある依存プロパティを表示します。 |
Visible | Boolean | プロパティが接続UI に表示されるかどうかを通知します。 |
ETC | String | プロパティに関するその他のさまざまな情報。 |
Cloud がデータソースにオフロードできるSELECT クエリ処理について説明します。
SQL 構文の詳細については、SQL 準拠 を参照してください。
以下はSQL 機能のサンプルデータセットです。 SELECT 機能のいくつかの側面がサポートされている場合には、カンマ区切りのリストで返されます。サポートされていない場合、カラムにはNO が入ります。
名前 | 説明 | 有効な値 |
AGGREGATE_FUNCTIONS | サポートされている集計関数。 | AVG, COUNT, MAX, MIN, SUM, DISTINCT |
COUNT | COUNT 関数がサポートされているかどうか。 | YES, NO |
IDENTIFIER_QUOTE_OPEN_CHAR | 識別子をエスケープするための開始文字。 | [ |
IDENTIFIER_QUOTE_CLOSE_CHAR | 識別子をエスケープするための終了文字。 | ] |
SUPPORTED_OPERATORS | サポートされているSQL 演算子。 | =, >, <, >=, <=, <>, !=, LIKE, NOT LIKE, IN, NOT IN, IS NULL, IS NOT NULL, AND, OR |
GROUP_BY | GROUP BY がサポートされているかどうか。サポートされている場合、どのレベルでサポートされているか。 | NO, NO_RELATION, EQUALS_SELECT, SQL_GB_COLLATE |
OJ_CAPABILITIES | サポートされている外部結合の種類。 | NO, LEFT, RIGHT, FULL, INNER, NOT_ORDERED, ALL_COMPARISON_OPS |
OUTER_JOINS | 外部結合がサポートされているかどうか。 | YES, NO |
SUBQUERIES | サブクエリがサポートされているかどうか。サポートされていれば、どのレベルでサポートされているか。 | NO, COMPARISON, EXISTS, IN, CORRELATED_SUBQUERIES, QUANTIFIED |
STRING_FUNCTIONS | サポートされている文字列関数。 | LENGTH, CHAR, LOCATE, REPLACE, SUBSTRING, RTRIM, LTRIM, RIGHT, LEFT, UCASE, SPACE, SOUNDEX, LCASE, CONCAT, ASCII, REPEAT, OCTET, BIT, POSITION, INSERT, TRIM, UPPER, REGEXP, LOWER, DIFFERENCE, CHARACTER, SUBSTR, STR, REVERSE, PLAN, UUIDTOSTR, TRANSLATE, TRAILING, TO, STUFF, STRTOUUID, STRING, SPLIT, SORTKEY, SIMILAR, REPLICATE, PATINDEX, LPAD, LEN, LEADING, KEY, INSTR, INSERTSTR, HTML, GRAPHICAL, CONVERT, COLLATION, CHARINDEX, BYTE |
NUMERIC_FUNCTIONS | サポートされている数値関数。 | ABS, ACOS, ASIN, ATAN, ATAN2, CEILING, COS, COT, EXP, FLOOR, LOG, MOD, SIGN, SIN, SQRT, TAN, PI, RAND, DEGREES, LOG10, POWER, RADIANS, ROUND, TRUNCATE |
TIMEDATE_FUNCTIONS | サポートされている日付および時刻関数。 | NOW, CURDATE, DAYOFMONTH, DAYOFWEEK, DAYOFYEAR, MONTH, QUARTER, WEEK, YEAR, CURTIME, HOUR, MINUTE, SECOND, TIMESTAMPADD, TIMESTAMPDIFF, DAYNAME, MONTHNAME, CURRENT_DATE, CURRENT_TIME, CURRENT_TIMESTAMP, EXTRACT |
REPLICATION_SKIP_TABLES | レプリケーション中にスキップされたテーブルを示します。 | |
REPLICATION_TIMECHECK_COLUMNS | レプリケーション中に更新判断のカラムとして使用するかどうかを、(指定された順に)チェックするカラムのリストを含む文字列の配列。 | |
IDENTIFIER_PATTERN | 識別子としてどの文字列が有効かを示す文字列値。 | |
SUPPORT_TRANSACTION | プロバイダーが、コミットやロールバックなどのトランザクションをサポートしているかどうかを示します。 | YES, NO |
DIALECT | 使用するSQL ダイアレクトを示します。 | |
KEY_PROPERTIES | Uniform データベースを特定するプロパティを示します。 | |
SUPPORTS_MULTIPLE_SCHEMAS | プロバイダー用に複数のスキームが存在するかどうかを示します。 | YES, NO |
SUPPORTS_MULTIPLE_CATALOGS | プロバイダー用に複数のカタログが存在するかどうかを示します。 | YES, NO |
DATASYNCVERSION | このドライバーにアクセスするために必要な、CData Sync のバージョン。 | Standard, Starter, Professional, Enterprise |
DATASYNCCATEGORY | このドライバーのCData Sync カテゴリ。 | Source, Destination, Cloud Destination |
SUPPORTSENHANCEDSQL | API で提供されている以上の、追加SQL 機能がサポートされているかどうか。 | TRUE, FALSE |
SUPPORTS_BATCH_OPERATIONS | バッチ操作がサポートされているかどうか。 | YES, NO |
SQL_CAP | このドライバーでサポートされているすべてのSQL 機能。 | SELECT, INSERT, DELETE, UPDATE, TRANSACTIONS, ORDERBY, OAUTH, ASSIGNEDID, LIMIT, LIKE, BULKINSERT, COUNT, BULKDELETE, BULKUPDATE, GROUPBY, HAVING, AGGS, OFFSET, REPLICATE, COUNTDISTINCT, JOINS, DROP, CREATE, DISTINCT, INNERJOINS, SUBQUERIES, ALTER, MULTIPLESCHEMAS, GROUPBYNORELATION, OUTERJOINS, UNIONALL, UNION, UPSERT, GETDELETED, CROSSJOINS, GROUPBYCOLLATE, MULTIPLECATS, FULLOUTERJOIN, MERGE, JSONEXTRACT, BULKUPSERT, SUM, SUBQUERIESFULL, MIN, MAX, JOINSFULL, XMLEXTRACT, AVG, MULTISTATEMENTS, FOREIGNKEYS, CASE, LEFTJOINS, COMMAJOINS, WITH, LITERALS, RENAME, NESTEDTABLES, EXECUTE, BATCH, BASIC, INDEX |
PREFERRED_CACHE_OPTIONS | 使用したいcacheOptions を指定する文字列値。 | |
ENABLE_EF_ADVANCED_QUERY | ドライバーがEntity Framework の高度なクエリをサポートしているかどうかを示します。サポートしていなければ、クエリはクライアントサイドで処理されます。 | YES, NO |
PSEUDO_COLUMNS | 利用可能な疑似カラムを示す文字列の配列。 | |
MERGE_ALWAYS | 値がtrue であれば、CData Sync 内でMerge Model が強制的に実行されます。 | TRUE, FALSE |
REPLICATION_MIN_DATE_QUERY | レプリケート開始日時を返すSELECT クエリ。 | |
REPLICATION_MIN_FUNCTION | サーバーサイドでmin を実行するために使用する式名を、プロバイダーが指定できるようになります。 | |
REPLICATION_START_DATE | レプリケート開始日を、プロバイダーが指定できるようになります。 | |
REPLICATION_MAX_DATE_QUERY | レプリケート終了日時を返すSELECT クエリ。 | |
REPLICATION_MAX_FUNCTION | サーバーサイドでmax を実行するために使用する式名を、プロバイダーが指定できるようになります。 | |
IGNORE_INTERVALS_ON_INITIAL_REPLICATE | 初回のレプリケートで、レプリケートをチャンクに分割しないテーブルのリスト。 | |
CHECKCACHE_USE_PARENTID | CheckCache 構文を親キーカラムに対して実行するかどうかを示します。 | TRUE, FALSE |
CREATE_SCHEMA_PROCEDURES | スキーマファイルの生成に使用できる、ストアドプロシージャを示します。 |
次のクエリは、WHERE 句で使用できる演算子を取得します。
SELECT * FROM sys_sqlinfo WHERE Name = 'SUPPORTED_OPERATORS'
WHERE 句では、個々のテーブルの制限や要件が異なる場合がありますので注意してください。詳しくは、データモデル セクションを参照してください。
Name | Type | Description |
NAME | String | SQL 構文のコンポーネント、またはサーバー上で処理できる機能。 |
VALUE | String | サポートされるSQL またはSQL 構文の詳細。 |
試行された変更に関する情報を返します。
次のクエリは、バッチ処理で変更された行のId を取得します。
SELECT * FROM sys_identity
Name | Type | Description |
Id | String | データ変更処理から返された、データベース生成Id。 |
Batch | String | バッチの識別子。1 は単一処理。 |
Operation | String | バッチ内の処理の結果:INSERTED、UPDATED、またはDELETED。 |
Message | String | SUCCESS、またはバッチ内の更新が失敗した場合のエラーメッセージ。 |
プロパティ | 説明 |
URL | The base URL of the Odoo site you're connecting to. For example, http://my.odoo.com/. |
Database | The name of the Odoo database you're connecting to. |
OdooEdition | The edition of Odoo being used. Set either Odoo Online or Odoo On-Premise. |
User | The Odoo user account used to authenticate. |
APIToken | The API token (or password) used to authenticate the user. |
CheckPermissions | Whether to use Odoo user's permissions to determine which tables and views to list. |
プロパティ | 説明 |
SSLServerCert | TLS/SSL を使用して接続するときに、サーバーが受け入れ可能な証明書。 |
プロパティ | 説明 |
Verbosity | ログファイルの記述をどの程度の詳細さで記載するかを決定するverbosity レベル。 |
プロパティ | 説明 |
BrowsableSchemas | このプロパティは、使用可能なスキーマのサブセットにレポートされるスキーマを制限します。例えば、BrowsableSchemas=SchemaA,SchemaB,SchemaC です。 |
AllowComputedFields | Boolean determining whether computed names from Odoo are mapped to columns. |
ExpandReferences | Boolean determining if multi-valued Many2Many and One2Many fields are expanded into separate rows. |
ShowParameterizedTables | Show tables that require inputs. |
UseDisplayNames | Boolean determining if the display names for the columns should be used instead of the API names. |
プロパティ | 説明 |
Language | This property specifies the language in which the data should be returned. |
MaxRows | クエリで集計またはGROUP BY を使用しない場合に返される行数を制限します。これはLIMIT 句よりも優先されます。 |
Pagesize | Odoo から返されるページあたりの結果の最大数。 |
PseudoColumns | このプロパティは、テーブルのカラムとして疑似カラムが含まれているかどうかを示します。 |
Timeout | タイムアウトエラーがスローされ、処理をキャンセルするまでの秒数。 |
このセクションでは、本プロバイダーの接続文字列で設定可能なAuthentication プロパティの全リストを提供します。
プロパティ | 説明 |
URL | The base URL of the Odoo site you're connecting to. For example, http://my.odoo.com/. |
Database | The name of the Odoo database you're connecting to. |
OdooEdition | The edition of Odoo being used. Set either Odoo Online or Odoo On-Premise. |
User | The Odoo user account used to authenticate. |
APIToken | The API token (or password) used to authenticate the user. |
CheckPermissions | Whether to use Odoo user's permissions to determine which tables and views to list. |
The base URL of the Odoo site you're connecting to. For example, http://my.odoo.com/.
string
""
The base URL of the Odoo site you're connecting to. For example, http://my.odoo.com/.
The name of the Odoo database you're connecting to.
string
""
When connecting to Odoo online, this value is usually the name of your custom Odoo domain. For example, if you connect to https://contoso.odoo.com, then the Database will be contoso. This property will be interpreted from the URL property.
When connecting to an on-premise instance of Odoo, you can find this value by logging out of Odoo and opening the Manage Databases page from the login screen. There, you can determine the database you need to connect to.
The edition of Odoo being used. Set either Odoo Online or Odoo On-Premise.
string
"Odoo Online"
The edition of Odoo being used. Set either Odoo Online or Odoo On-Premise. When the OdooEdition is set to Odoo Online, the driver will consider the System's culture while processing the float/decimal/double data types for Insert statements.
The Odoo user account used to authenticate.
string
""
Together with APIToken, this field is used to authenticate against the Odoo server.
The API token (or password) used to authenticate the user.
string
""
When using Odoo 14 and above, this option can be set to either an API token or password. API tokens are recommended over passwords.
Whether to use Odoo user's permissions to determine which tables and views to list.
bool
true
Each user in Odoo has different permissions to some models - they can modify some, read others, and may not be able to access some at all. When CheckPermissions is true (the default), the model permissions are examined so that modifiable models are classified as tables, read-only models are classified as views, and inaccessible models are not listed.
When CheckPermissions is false, all the models within Odoo are listed as tables and the permissions check is skipped.
Checking model permissions requires an administrator to grant your user read-only access to the "ir.model.access" model because it is not readable to most users by default. If access to that model cannot be granted to the connecting user, then set this option to false.
このセクションでは、本プロバイダーの接続文字列で設定可能なSSL プロパティの全リストを提供します。
プロパティ | 説明 |
SSLServerCert | TLS/SSL を使用して接続するときに、サーバーが受け入れ可能な証明書。 |
TLS/SSL を使用して接続するときに、サーバーが受け入れ可能な証明書。
string
""
TLS/SSL 接続を使用する場合は、このプロパティを使用して、サーバーが受け入れるTLS/SSL 証明書を指定できます。コンピュータによって信頼されていない他の証明書はすべて拒否されます。
このプロパティは、次のフォームを取ります:
説明 | 例 |
フルPEM 証明書(例では省略されています) | -----BEGIN CERTIFICATE----- MIIChTCCAe4CAQAwDQYJKoZIhv......Qw== -----END CERTIFICATE----- |
証明書を保有するローカルファイルへのパス。 | C:\cert.cer |
公開鍵(例では省略されています) | -----BEGIN RSA PUBLIC KEY----- MIGfMA0GCSq......AQAB -----END RSA PUBLIC KEY----- |
MD5 Thumbprint (hex 値はスペースおよびコロン区切り) | ecadbdda5a1529c58a1e9e09828d70e4 |
SHA1 Thumbprint (hex 値はスペースおよびコロン区切り) | 34a929226ae0819f2ec14b4a3d904f801cbb150d |
これを指定しない場合は、マシンが信用するすべての証明書が受け入れられます。
すべての証明書の受け入れを示すには、'*'を使用します。セキュリティ上の理由から、これはお勧めできません。
このセクションでは、本プロバイダーの接続文字列で設定可能なLogging プロパティの全リストを提供します。
プロパティ | 説明 |
Verbosity | ログファイルの記述をどの程度の詳細さで記載するかを決定するverbosity レベル。 |
このセクションでは、本プロバイダーの接続文字列で設定可能なSchema プロパティの全リストを提供します。
プロパティ | 説明 |
BrowsableSchemas | このプロパティは、使用可能なスキーマのサブセットにレポートされるスキーマを制限します。例えば、BrowsableSchemas=SchemaA,SchemaB,SchemaC です。 |
AllowComputedFields | Boolean determining whether computed names from Odoo are mapped to columns. |
ExpandReferences | Boolean determining if multi-valued Many2Many and One2Many fields are expanded into separate rows. |
ShowParameterizedTables | Show tables that require inputs. |
UseDisplayNames | Boolean determining if the display names for the columns should be used instead of the API names. |
このプロパティは、使用可能なスキーマのサブセットにレポートされるスキーマを制限します。例えば、BrowsableSchemas=SchemaA,SchemaB,SchemaC です。
string
""
スキーマをデータベースからリストすると、負荷がかかる可能性があります。接続文字列でスキーマのリストを提供すると、 パフォーマンスが向上します。
Boolean determining whether computed names from Odoo are mapped to columns.
bool
false
Internally, Odoo stores some fields directly in its database and computes other fields dynamically when you request them. While stored fields are usually fast to retrieve, computed fields can potentially be much slower since Odoo has to do additional work on each row.
By default, this property is false and computed fields are not available. You can set this property to true if you need to access a computed field, although this will make queries (including star queries) on many tables take longer to run.
Boolean determining if multi-valued Many2Many and One2Many fields are expanded into separate rows.
bool
false
By default Many2Many and One2Many fields are collapsed into single values separated by commas.
For example, a record in calendar_event IDs will generate a result like this if partners 13 and 57 are attending.
SELECT id, name, partner_ids, x_custom_ids FROM calendar_event -- 1 'Meet With Potential Customer' '13,57' '1,2'
With this option enabled, the Cloud will expand each combination of multi-valued field values across multiple rows. This means that row data will be duplicated but makes it simpler to JOIN between tables that are linked by multi-valued references.
In addition, the Cloud will use a separate primary key called id:multi since id) not unique when rows are duplciated.
This primary key is generated client-side and its use should be avoided in filters, since it depends upon the exact rows returned by any filters evaluated by Odoo.
SELECT "id:multi", id, name, partner_ids, x_custom_ids FROM calendar_event -- 1:1 1 'Meet With Potential Customer' 13 1 -- 1:2 1 'Meet With Potential Customer' 57 1 -- 1:3 1 'Meet With Potential Customer' 13 2 -- 1:4 1 'Meet With Potential Customer' 57 2
Note that this option does not affect how INSERTs are processed. If you want to insert a record containing a multi-valued field you must always insert using a comma-separated value.
Show tables that require inputs.
bool
false
When this property is set to true, all the tables or views that require inputs to fetch data are displayed.
When this property is set to false, those tables and views are hidden.
The following is the complete list of tables that are shown/hidden based on the value of this property:
Boolean determining if the display names for the columns should be used instead of the API names.
bool
true
Display names may be changed in the future. Set this to false if you would like to ensure column names are always constant.
このセクションでは、本プロバイダーの接続文字列で設定可能なMiscellaneous プロパティの全リストを提供します。
プロパティ | 説明 |
Language | This property specifies the language in which the data should be returned. |
MaxRows | クエリで集計またはGROUP BY を使用しない場合に返される行数を制限します。これはLIMIT 句よりも優先されます。 |
Pagesize | Odoo から返されるページあたりの結果の最大数。 |
PseudoColumns | このプロパティは、テーブルのカラムとして疑似カラムが含まれているかどうかを示します。 |
Timeout | タイムアウトエラーがスローされ、処理をキャンセルするまでの秒数。 |
This property specifies the language in which the data should be returned.
string
""
This property can take one of the following values:
en_us (default) | English (US) |
es_MX | Spanish (MX) / Español (MX) |
es_MX | Spanish (MX) / Español (MX) |
sq_AL | Albanian / Shqip |
am_ET | Amharic / አምሃርኛ |
ar_SY | Arabic (Syria) / الْعَرَبيّة |
ar_001 | Arabic / الْعَرَبيّة |
az_AZ | Azerbaijani / Azərbaycanca |
eu_ES | Basque / Euskara |
bn_IN | Bengali / বাংলা |
bs_BA | Bosnian / bosanski jezik |
bg_BG | Bulgarian / български език |
my_MM | Burmese / ဗမာစာ |
ca_ES | Catalan / Català |
zh_HK | Chinese (HK) |
zh_CN | Chinese (Simplified) / 简体中文 |
zh_TW | Chinese (Traditional) / 繁體中文 |
hr_HR | Croatian / hrvatski jezik |
cs_CZ | Czech / Čeština |
da_DK | Danish / Dansk |
nl_BE | Dutch (BE) / Nederlands (BE) |
nl_NL | Dutch / Nederlands |
en_AU | English (AU) |
en_CA | English (CA) |
en_IN | English (IN) |
en_NZ | English (NZ) |
en_GB | English (UK) |
et_EE | Estonian / Eesti keel |
fi_FI | Finnish / Suomi |
fr_BE | French (BE) / Français (BE) |
fr_CA | French (CA) / Français (CA) |
fr_CH | French (CH) / Français (CH) |
fr_FR | French / Français |
gl_ES | Galician / Galego |
ka_GE | Georgian / ქართული ენა |
de_CH | German (CH) / Deutsch (CH) |
de_DE | German / Deutsch |
el_GR | Greek / Ελληνικά |
gu_IN | Gujarati / ગુજરાતી |
he_IL | Hebrew / עִבְרִי |
hi_IN | Hindi / हिंदी |
hu_HU | Hungarian / Magyar |
id_ID | Indonesian / Bahasa Indonesia |
it_IT | Italian / Italiano |
ja_JP | Japanese / 日本語 |
kab_DZ | Kabyle / Taqbaylit |
km_KH | Khmer / ភាសាខ្មែរ |
ko_KP | Korean (KP) / 한국어 (KP) |
ko_KR | Korean (KR) / 한국어 (KR) |
lo_LA | Lao / ພາສາລາວ |
lv_LV | Latvian / latviešu valoda |
lt_LT | Lithuanian / Lietuvių kalba |
lb_LU | Luxembourgish |
mk_MK | Macedonian / македонски јазик |
ms_MY | Malay / Bahasa Melayu |
ml_IN | Malayalam / മലയാളം |
mn_MN | Mongolian / монгол |
nb_NO | Norwegian Bokmål / Norsk bokmål |
fa_IR | Persian / فارسی |
pl_PL | Polish / Język polski |
pt_AO | Portuguese (AO) / Português (AO) |
pt_BR | Portuguese (BR) / Português (BR) |
pt_PT | Portuguese / Português |
ro_RO | Romanian / română |
ru_RU | Russian / русский язык |
sr_RS | Serbian (Cyrillic) / српски |
sr@latin | Serbian (Latin) / srpski |
sk_SK | Slovak / Slovenský jazyk |
sl_SI | Slovenian / slovenščina |
es_AR | Spanish (AR) / Español (AR) |
es_BO | Spanish (BO) / Español (BO) |
es_CL | Spanish (CL) / Español (CL) |
es_CO | Spanish (CO) / Español (CO) |
es_CR | Spanish (CR) / Español (CR) |
es_DO | Spanish (DO) / Español (DO) |
es_EC | Spanish (EC) / Español (EC) |
es_GT | Spanish (GT) / Español (GT) |
es_419 | Spanish (Latin America) / Español (América Latina) |
es_PA | Spanish (PA) / Español (PA) |
es_PE | Spanish (PE) / Español (PE) |
es_PY | Spanish (PY) / Español (PY) |
es_UY | Spanish (UY) / Español (UY) |
es_VE | Spanish (VE) / Español (VE) |
es_ES | Spanish / Español |
sv_SE | Swedish / Svenska |
tl_PH | Tagalog / Filipino |
te_IN | Telugu / తెలుగు |
th_TH | Thai / ภาษาไทย |
tr_TR | Turkish / Türkçe |
uk_UA | Ukrainian / українська |
vi_VN | Vietnamese / Tiếng Việt |
クエリで集計またはGROUP BY を使用しない場合に返される行数を制限します。これはLIMIT 句よりも優先されます。
int
-1
クエリで集計またはGROUP BY を使用しない場合に返される行数を制限します。これはLIMIT 句よりも優先されます。
Odoo から返されるページあたりの結果の最大数。
int
5000
Pagesize プロパティは、Odoo から返されるページあたりの結果の最大数に影響を与えます。より大きい値を設定すると、1ページあたりの消費メモリが増える代わりに、パフォーマンスが向上する場合があります。
このプロパティは、テーブルのカラムとして疑似カラムが含まれているかどうかを示します。
string
""
Entity Framework ではテーブルカラムでない疑似カラムに値を設定できないため、この設定はEntity Framework で特に便利です。この接続設定の値は、"Table1=Column1, Table1=Column2, Table2=Column3" の形式です。"*=*" のように"*" 文字を使用して、すべてのテーブルとすべてのカラムを含めることができます。
タイムアウトエラーがスローされ、処理をキャンセルするまでの秒数。
int
60
Timeout が0に設定されている場合は、操作がタイムアウトしません。処理が正常に完了するか、エラー状態になるまで実行されます。
Timeout の有効期限が切れても処理が完了していない場合は、Cloud は例外をスローします。