機械翻訳について

ジャンプ先

• 要求
• レスポンス
• 例

トランザクション設定の取得

get

/essbase/rest/v1/applications/{applicationName}/databases/{databaseName}/settings/transactions

指定されたデータベースのトランザクション設定を返します。

要求

パス・パラメータ

• applicationName: string

  アプリケーション名

• databaseName: string

  データベース名

先頭に戻る

レスポンス

サポートされるメディア・タイプ

• application/json
• application/xml

200 レスポンス

OK

トランザクション設定が正常に返されました。

本文()

ルート・スキーマ : transactions

タイプ: object

Show Source

• commitBlocks(optional): integer(int64)

  明示的なコミットが実行されるまでに更新されるデータ・ブロックの数(計算およびグリッドの更新時)。 committedAccessがfalseの場合に適用されます。

• commitRows(optional): integer(int64)

  明示的なコミットが実行される前に(データ・ロード中に)処理された入力ファイルの行数。 committedAccessがfalseの場合に適用されます。

• committedAccess(optional): boolean

  trueの場合、分離レベルをコミット済アクセスに設定します。つまり、データ・ブロックを更新できるのは一度に1つのトランザクションのみであり、Essbaseはトランザクションおよびコミット操作が実行されるまですべてのデータ・ブロックの読取り/書込みロックを保持します。 concurrencyPreImageAccessが有効になっている場合でも、ユーザー(またはトランザクション)は最後のコミット・ポイントでデータに読取り専用アクセスできます。 デフォルトはfalseです。

• concurrencyPreImageAccess(optional): boolean

  trueの場合、キューブがコミット・モードのときに、最後のコミット・ポイントでのデータへの読取り専用アクセスをユーザー(または他のトランザクション)に許可します(つまり、同時トランザクション中はデータ・ブロックがロックされる可能性があります)。 committedAccessが有効な場合、デフォルトはtrueです。

• concurrencyWaitSeconds(optional): integer(int32)

  ロック・タイムアウト間隔。データベースがコミット・モードのときにブロックがロック解除されるまで待機する秒数。 割り当てられた時間内に付与できないトランザクション・リクエストが行われた場合、ロックが付与されるまでトランザクションはロールバックされます。 committedAccessがtrueの場合にのみ適用されます。

{
    "type":"object",
    "properties":{
        "committedAccess":{
            "type":"boolean",
            "description":"<p>If <b>true</b>, sets the isolation level to committed access, meaning that only one transaction at a time can update data blocks, and Essbase holds read/write locks on all data blocks until the transaction and the commit operations are performed. If concurrencyPreImageAccess is enabled, users (or transactions) can still have read-only access to data at its last commit point. The default is <b>false</b>.</p>"
        },
        "concurrencyWaitSeconds":{
            "type":"integer",
            "description":"<p>Lock timeout interval; number of seconds to wait for blocks to be unlocked when the database is in committed mode. If a transaction request is made that cannot be granted in the allotted time, the transaction is rolled back until a lock can be granted. Applicable only when committedAccess is <b>true</b>.</p>",
            "format":"int32"
        },
        "concurrencyPreImageAccess":{
            "type":"boolean",
            "description":"<p>If <b>true</b>, allow users (or other transactions) read-only access to data at its last commit point  when the cube is in committed mode (meaning that data blocks may be locked for the duration of a concurrent transaction). The default is <b>true</b>, when committedAccess is enabled.</p>"
        },
        "commitBlocks":{
            "type":"integer",
            "description":"<p>The number of data blocks updated before an explicit commit is performed (during calculation and grid updates). Applicable when committedAccess is <b>false</b>.</p>",
            "format":"int64"
        },
        "commitRows":{
            "type":"integer",
            "description":"<p>The number of rows of the input file processed before an explicit commit is performed (during data load). Applicable when committedAccess is <b>false</b>.</p>",
            "format":"int64"
        }
    },
    "xml":{
        "name":"transactions"
    }
}

400 レスポンス

不正なリクエスト

トランザクション設定の取得に失敗しました。 アプリケーション名またはデータベース名が正しくない可能性があります。

500 レスポンス

内部サーバー・エラー。

先頭に戻る

例

次の例では、cURLを使用してWindowsシェル・スクリプトからREST APIにアクセスし、ブロック・ストレージ・キューブのトランザクション設定を取得する方法を示します。

コール元のユーザーIDおよびパスワードは、properties.batで値が設定される変数です。

cURLコマンドを含むスクリプト

call properties.bat
curl -X GET "https://192.0.2.1:443/essbase/rest/v1/applications/Sample/databases/Basic/settings/transactions"
     -H  "accept: application/json"
     -u %User%:%Password

レスポンス本体の例

{
  "transactions": {
    "committedAccess": false,
    "concurrencyWaitSeconds": 20,
    "concurrencyPreImageAccess": true,
    "commitBlocks": 3000,
    "commitRows": 0
  }
}

先頭に戻る