Oracle® TimesTen In-Memory Database

リファレンス

11gリリース2(11.2.2)

B66447-09(原本部品番号:E21643-26)

2015年3月

Oracle TimesTen In-Memory Databaseリファレンス, 11gリリース2(11.2.2)

B66447-09

Copyright © 2015, Oracle and/or its affiliates.All rights reserved.

このソフトウェアおよび関連ドキュメントの使用と開示は、ライセンス契約の制約条件に従うものとし、知的財産に関する法律により保護されています。ライセンス契約で明示的に許諾されている場合もしくは法律によって認められている場合を除き、形式、手段に関係なく、いかなる部分も使用、複写、複製、翻訳、放送、修正、ライセンス供与、送信、配布、発表、実行、公開または表示することはできません。このソフトウェアのリバース・エンジニアリング、逆アセンブル、逆コンパイルは互換性のために法律によって規定されている場合を除き、禁止されています。

ここに記載された情報は予告なしに変更される場合があります。また、誤りが無いことの保証はいたしかねます。誤りを見つけた場合は、オラクル社までご連絡ください。

このソフトウェアまたは関連ドキュメントを、米国政府機関もしくは米国政府機関に代わってこのソフトウェアまたは関連ドキュメントをライセンスされた者に提供する場合は、次の通知が適用されます。

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations.As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs.No other rights are granted to the U.S. Government.

このソフトウェアもしくはハードウェアは様々な情報管理アプリケーションでの一般的な使用のために開発されたものです。このソフトウェアもしくはハードウェアは、危険が伴うアプリケーション(人的傷害を発生させる可能性があるアプリケーションを含む)への用途を目的として開発されていません。このソフトウェアもしくはハードウェアを危険が伴うアプリケーションで使用する際、安全に使用するために、適切な安全装置、バックアップ、冗長性(redundancy)、その他の対策を講じることは使用者の責任となります。このソフトウェアもしくはハードウェアを危険が伴うアプリケーションで使用したことに起因して損害が発生しても、オラクル社およびその関連会社は一切の責任を負いかねます。

OracleおよびJavaはOracle Corporationおよびその関連企業の登録商標です。その他の名称は、それぞれの所有者の商標または登録商標です。

Intel、Intel Xeonは、Intel Corporationの商標または登録商標です。すべてのSPARCの商標はライセンスをもとに使用し、SPARC International, Inc.の商標または登録商標です。AMD、Opteron、AMDロゴ、AMD Opteronロゴは、Advanced Micro Devices, Inc.の商標または登録商標です。UNIXは、The Open Groupの登録商標です。

このソフトウェアまたはハードウェア、そしてドキュメントは、第三者のコンテンツ、製品、サービスへのアクセス、あるいはそれらに関する情報を提供することがあります。オラクル社との間で該当する取決めにて別途規定しないかぎり、オラクル社およびその関連会社は、第三者のコンテンツ、製品、サービスに関して一切の責任を負わず、いかなる保証もいたしません。オラクル社との間で該当する取決めにて別途規定する場合を除き、オラクル社およびその関連会社は、第三者のコンテンツ、製品、サービスへのアクセスまたは使用によって損失、費用、あるいは損害が発生しても、一切の責任を負いかねます。

目次

タイトルおよび著作権情報

はじめに

- 対象読者

- 関連ドキュメント

- 表記規則

- ドキュメントのアクセシビリティについて

新機能

- リリース11.2.2.7.0の新機能

- リリース11.2.2.6.0の新機能

- リリース11.2.2.5.0の新機能

- リリース11.2.2.4.0の新機能

- リリース11.2.2.2.0の新機能

- リリース11.2.2.1.0の新機能

1 接続属性

- 属性に必要な権限

- 属性のリスト

- データ・ストア属性

- データ・ソース名

- DataStore

- DatabaseCharacterSet

- サポートされているキャラクタ・セット

- Description

- Driver

- LogDir

- Preallocate

- RangeIndexType

- ReplicationApplyOrdering

- ReplicationParallelism

- Temporary

- TypeMode

- 初期接続属性

- AutoCreate

- CkptFrequency

- CkptLogVolume

- CkptRate

- CkptReadThreads

- Connections

- ForceConnect

- LogAutoTruncate

- LogBufMB

- LogBufParallelism

- LogFileSize

- LogFlushMethod

- LogPurge

- MemoryLock

- Overwrite

- PermSize

- ReceiverThreads

- RecoveryThreads

- TempSize

- 一般接続属性

- CommitBufferSizeMax

- ConnectionName

- DDLCommitBehavior

- DDLReplicationAction

- DDLReplicationLevel

- Diagnostics

- DuplicateBindMode

- DurableCommits

- Isolation

- LockLevel

- LockWait

- MatchLogOpts

- PermWarnThreshold

- PrivateCommands

- PWDCrypt

- QueryThreshold

- ReplicationTrack

- SQLQueryTimeout

- TempWarnThreshold

- UIDおよびPWD

- WaitForConnect

- NLS一般接続属性

- ConnectionCharacterSet

- NLS_LENGTH_SEMANTICS

- NLS_NCHAR_CONV_EXCP

- NLS_SORT

- サポートされている言語ソート

- PL/SQLの初期接続属性

- PLSQL

- PLSQL_MEMORY_ADDRESS

- PLSQL_MEMORY_SIZE

- PL/SQLの一般接続属性

- PLSCOPE_SETTINGS

- PLSQL_CCFLAGS

- PLSQL_CONN_MEM_LIMIT

- PLSQL_OPTIMIZE_LEVEL

- PLSQL_TIMEOUT

- TimesTen Cacheの初期接続属性

- CacheAWTMethod

- TimesTen Cacheのデータベース属性

- CacheAWTParallelism

- CacheGridEnable

- CacheGridMsgWait

- TimesTen Cacheの一般接続属性

- DynamicLoadEnable

- DynamicLoadErrorMode

- OracleNetServiceName

- OraclePWD

- PassThrough

- RACCallback

- TimesTen Client接続属性

- TCP_Port

- TCP_Port2

- TTC_FailoverPortRange

- TTC_Server

- TTC_Server2

- TTC_Server_DSN

- TTC_Server_DSN2

- TTC_Timeout

- サーバー接続属性

- MaxConnsPerServer

- ServersPerDSN

- ServerStackSize

2 組込みプロシージャ

- ttAgingLRUConfig

- ttAgingScheduleNow

- ttApplicationContext

- ttBackupStatus

- ttBlockInfo

- ttBookmark

- ttCacheAllowFlushAwtSet

- ttCacheAutorefIntervalStatsGet

- ttCacheAutorefresh

- ttCacheAutorefreshLogDefrag

- ttCacheAutorefreshStatsGet

- ttCacheAutorefreshSelectLimit

- ttCacheAutorefreshXactLimit

- ttCacheAWTMonitorConfig

- ttCacheAWTThresholdGet

- ttCacheAWTThresholdSet

- ttCacheCheck

- ttCacheConfig

- ttCacheDbCgStatus

- ttCacheDDLTrackingConfig

- ttCachePolicyGet

- ttCachePolicySet

- ttCachePropagateFlagSet

- ttCacheSqlGet

- ttCacheStart

- ttCacheStop

- ttCacheUidGet

- ttCacheUidPwdSet

- ttCkpt

- ttCkptBlocking

- ttCkptConfig

- ttCkptHistory

- ttCommitBufferStats

- ttCommitBufferStatsReset

- ttCompact

- ttCompactTS

- ttComputeTabSizes

- ttConfiguration

- ttContext

- ttDataStoreStatus

- ttDBConfig

- ttDbWriteConcurrencyModeGet

- ttDbWriteConcurrencyModeSet

- ttDurableCommit

- ttGridAttach

- ttGridCheckOwner

- ttGridCreate

- ttGridDestroy

- ttGridDetach

- ttGridDetachAll

- ttGridDetachList

- ttGridFirstMemberAttach

- ttGridGlobalCGResume

- ttGridGlobalCGSuspend

- ttGridInfo

- ttGridNameSet

- ttGridNodeStatus

- ttHostNameGet

- ttHostNameSet

- ttIndexAdviceCaptureDrop

- ttIndexAdviceCaptureEnd

- ttIndexAdviceCaptureInfoGet

- ttIndexAdviceCaptureOutput

- ttIndexAdviceCaptureStart

- ttLoadFromOracle

- ttLockLevel

- ttLockWait

- ttLogHolds

- ttMonitorHighWaterReset

- ttOptClearStats

- ttOptCmdCacheInvalidate

- ttOptEstimateStats

- ttOptGetColStats

- ttOptGetFlag

- ttOptGetMaxCmdFreeListCnt

- ttOptGetOrder

- ttOptSetColIntvlStats

- ttOptSetColStats

- ttOptSetFlag

- ttOptSetMaxCmdFreeListCnt

- ttOptSetMaxPriCmdFreeListCnt

- ttOptSetOrder

- ttOptSetTblStats

- ttOptShowJoinOrder

- ttOptStatsExport

- ttOptUpdateStats

- ttOptUseIndex

- ttPLSQLMemoryStats

- ttRamPolicyAutoReloadGet

- ttRamPolicyAutoReloadSet

- ttRamPolicyGet

- ttRamPolicySet

- ttRedundantIndexCheck

- ttRepDeactivate

- ttReplicationStatus

- ttRepPolicyGet

- ttRepPolicySet

- ttRepQueryThresholdGet

- ttRepQueryThresholdSet

- ttRepStart

- ttRepStateGet

- ttRepStateSave

- ttRepStateSet

- ttRepStop

- ttRepSubscriberStateSet

- ttRepSubscriberWait

- ttRepSyncGet

- ttRepSyncSet

- ttRepSyncSubscriberStatus

- ttRepTransmitGet

- ttRepTransmitSet

- ttRepXactStatus

- ttRepXactTokenGet

- ttSetUserColumnID

- ttSetUserTableID

- ttSize

- ttSQLCmdCacheInfo

- ttSQLCmdCacheInfo2

- ttSQLCmdCacheInfoGet

- ttSQLCmdQueryPlan

- ttSQLExecutionTimeHistogram

- ttStatsConfig

- ttTableSchemaFromOraQueryGet

- ttVersion

- ttWarnOnLowMemory

- ttXactIdGet

- ttXlaBookmarkCreate

- ttXlaBookmarkDelete

- ttXlaSubscribe

- ttXlaUnsubscribe

3 ユーティリティ

- 概要

- ユーティリティに必要な認証および認可

- ユーティリティに必要なユーザー認証

- ユーティリティの実行に必要な権限

- ttAdmin

- ttAdoptStores

- ttBackup

- ttBulkCp

- ttCacheAdvisor

- ttCapture

- ttCheck

- ttCWAdmin

- ttDaemonAdmin

- ttDaemonLog

- ttDestroy

- ttIsql

- ttMigrate

- ttmodinstall

- ttRepAdmin

- ヘルプおよびバージョン情報

- データベース情報

- サブスクライバ・データベース処理

- データベースの複製

- 更新完了の待機

- レプリケーション・ステータス

- ttRestore

- ttSchema

- ttSize

- ttStats

- ttStatus

- ttSyslogCheck(UNIX)

- ttTail

- ttTraceMon

- ttUser

- ttVersion

- ttXactAdmin

- ttXactLog

4 システム制限

- システム制限およびデフォルト

- オープン・ファイル数の制限

- パス名

索引

はじめに

Oracle TimesTen In-Memory Database (TimesTen)は、高速なレスポンスとスループットのためのメモリーが最適化されたリレーショナル・データベースです。このデータベースは、実行時にメモリー内に完全に格納され、ディスク記憶域にデータを記録することでリカバリおよび再起動が可能です。レプリケーション機能によって、高可用性が実現されます。TimesTenでは、OracleインタフェースであるPL/SQL、OCIおよびPro*C/C++に加えて、標準的なアプリケーション・インタフェースであるSQL、JDBC、ODBCおよびODP.NETがサポートされます。TimesTenは、単独で利用することも、Oracle Databaseのキャッシュとしても利用できます。

対象読者

このマニュアルでは、TimesTen属性、組込みプロシージャおよびユーティリティの参照情報について説明しています。このマニュアルは、データベース・システムに関する基本的な知識を持つユーザーを対象としています。

関連ドキュメント

TimesTenのドキュメントは、次の場所のOracle Technology Networkで入手できます。

http://www.oracle.com/technetwork/database/database-technologies/timesten/documentation/index.html

表記規則

TimesTenは複数のプラットフォームをサポートしています。このマニュアルに記述されている内容は、特に表記しないかぎり、サポートされるすべてのプラットフォームに適用されます。WindowsはサポートされているすべてのWindowsプラットフォームを表します。UNIXはサポートされているすべてのUNIXプラットフォームおよびLinuxを表します。TimesTenでサポートされている特定のプラットフォーのバージョンの詳細は、『Oracle TimesTen In-Memory Databaseリリース・ノート』のプラットフォームに関する説明を参照してください。

注意:
TimesTenのドキュメントでは、「データ・ストア」と「データベース」という用語を同じ意味で使用しています。両方の用語は、TimesTenデータベースを指します。

このマニュアルでは次の表記規則を使用します。

規則

意味

イタリック体

イタリックは、本文中で定義されている用語、ドキュメントのタイトルまたは強調を示します。

固定幅フォント

固定幅フォントは、コード、コマンド、URL、関数名、属性名、ディレクトリ名、ファイル名、画面に表示されるテキスト、または入力するテキストを示します。

固定幅フォントのイタリック

固定幅フォントのイタリックは、ユーザーが特定の値を使用または指定するコード例のプレースホルダまたは変数を示します。次に例を示します。
Driver=install_dir/lib/libtten.sl

install_dirをご使用のTimesTenインストール・ディレクトリに置き換えます。

[ ]

大カッコは、カッコ内の項目を任意に選択することを表します。大カッコは、入力しないでください。

{ }

中カッコは、カッコ内の項目のうち、1つが必須であることを表します。中カッコは、入力しないでください。

|

選択項目の引数を区切る縦線(パイプ)。

. . .

引数の後の水平の省略記号は、1行のコマンドラインで複数の引数を使用できることを表します。コード例の中の水平の省略記号は、例の一部だけが表示されていることを示します。

%

%は、UNIXのシェル・プロンプトを表します。

また、TimesTenのドキュメントでは、次の特別な表記規則を使用します。

規則

意味

install_dir

TimesTenがインストールされているディレクトリのパスです。

TTinstance

TimesTenのインストールで指定するインスタンス名です。インストール時に、一意のインスタンス名でTimesTenの各インストールを識別する必要があります。この名前はインストール・パスに表示されます。

bitsまたはbb

32または64の2桁の数字は、32ビットまたは64ビットのオペレーティング・システムを表します。

releaseまたはrr

リリース番号の最初の3つの部分(ドットが付く場合と付かない場合があります)。リリース番号の最初の3つの部分は、TimesTenのメジャー・リリースを表します。たとえば、1122または11.2.2はTimesTen 11gリリース2 (11.2.2)を表します。

DSN

TimesTenのデータソース名(TimesTenデータベース用)です。

ドキュメントのアクセシビリティについて

Oracleのアクセシビリティについての詳細情報は、Oracle Accessibility ProgramのWebサイト(http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc)を参照してください。

Oracle Supportへのアクセス

サポートをご契約のお客様には、My Oracle Supportを通して電子支援サービスを提供しています。詳細情報は(http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info)か、聴覚に障害のあるお客様は(http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs)を参照してください。

新機能

この項では、このマニュアルで説明するOracle TimesTen In-Memory Database 11gリリース2(11.2.2)の新機能を説明し、詳細情報へのリンクを示します。

リリース11.2.2.7.0の新機能

- DDLReplicationLevelおよびDDLReplicationAction接続属性は、DDL文によって作成または削除されるどのオブジェクトがアクティブ・スタンバイ・ペアのレプリケーション・スキームに関連するデータベースに自動的にレプリケートされるかを制御します。このリリースでは、DDLReplicationLevel接続属性の新しいレベル3 (デフォルトではない)により、CREATE VIEWまたはDROP VIEW文、CREATE SEQUENCEまたはDROP SEQUENCE文およびアクティブ・スタンバイ・ペアのキャッシュ・マネージャにOracleパスワードを設定するためのUidPwdSet組込みプロシージャの実行結果のレプリケーションが追加されています。詳細は、DDLReplicationAction、DDLReplicationLevel、ttCacheUidPwdSetおよびttAdminに関する説明を参照してください。

- ユーザー・エラー・ログ・メッセージの新しいRECOVERY指定は、TimesTen自動リカバリのステータスを報告するメッセージに対応します。これはttDaemonLogユーティリティで制御できるカテゴリではないため、メッセージを無効にすることはできません。

- Oracle Clusterwareを使用する場合は、ユーザー名またはパスワードの変更後、新しいttCWAdmin -reauthenticateコマンドを実行して、この新しいユーザー名およびパスワードをOracle Clusterwareで保存できるようにする必要があります。詳細は、『Oracle TimesTen In-Memory Database開発者および管理者ガイド』のOracle Clusterwareを使用した場合のユーザー名またはパスワードの変更に関する説明を参照してください。「ttCWAdmin」も参照してください。

- ttIsql editコマンドを使用してファイルを編集するか、またはテキスト・エディタでttIsqlコマンドを編集します。ttIsql editコマンドは、emacs、geditまたはviなどのテキスト・エディタを起動します。詳細は、『Oracle TimesTen In-Memory Databaseオペレーション・ガイド』のttIsql editコマンドの使用に関する説明を参照してください。「ttIsql」も参照してください。

- ttIsqlユーティリティに、waitforresultコマンドも含まれるようになりました。このコマンドは、結果が1以上の列の場合を除き、waitforコマンドと同様です。「ttIsql」を参照してください。

リリース11.2.2.6.0の新機能

- 自動リフレッシュの処理に使用するキャッシュ・エージェントに対する再利用バッファのサイズを管理できます。自動リフレッシュ・キャッシュ・グループを含むアクティブ・スタンバイ・ペア・レプリケーション・スキームを使用する場合、レプリケーション・エージェントに対する再利用バッファのサイズも管理できます。「ttDBConfig」を参照してください。

- 同時書込み処理中の読取り最適化の制御を有効にするためのツールが追加されました。詳細は、「ttDbWriteConcurrencyModeGet」および「ttDbWriteConcurrencyModeSet」を参照してください。

リリース11.2.2.5.0の新機能

- TimesTenには、データベース・メトリックのスナップショットの収集および比較をサポートするために、ttStatsユーティリティが追加されています。

- cacheAWTMethodの最初の接続属性の値をttDBConfig組込みプロシージャによって設定できるようになりました。CacheParAwtBatchSizeパラメータを設定して、1つのバッチに含まれる行数に対するしきい値を構成できます。「ttDBConfig」を参照してください。

- 月末、四半期末、年度末のトランザクションなど、特定の時期に大規模なトランザクションを実行することがあります。また、短期間の間にOracle Databaseに対して大量のデータを変更または追加する状況もあります。読取り専用の自動リフレッシュ・キャッシュ・グループでは、自動リフレッシュ操作がこれらのいずれかの状況に適用された場合、TimesTenでは永続的な領域が不足する可能性があります。したがって、これらの状況に対して、自動リフレッシュ・トランザクション制限を設定して、大量のデータを分け、複数のより小さいトランザクションに対して適用し、コミットするようにできます。「ttCacheAutorefIntervalStatsGet」および「ttCacheAutorefreshXactLimit」を参照してください。

- 変更ログ表の長期間の使用や重いワークロードは、表領域の断片化につながります。変更ログ表の断片化による表領域の劣化を防ぐため、TimesTenでは表領域の断片化を計算して、表領域をデフラグし領域を再利用する方法を提供します。詳細は、「ttCacheAutorefreshLogDefrag」を参照してください。

- このリリースでは、レコードを再利用するために、トランザクション・コミット・バッファに割り当てられるメモリーの量を指定できます。詳細は、接続属性の「CommitBufferSizeMax」および組込みプロシージャの「ttCommitBufferStats」および「ttCommitBufferStatsReset」を参照してください。

- このリリースでは、AutorefreshLogDefrag組込みプロシージャを使用して、キャッシュ自動リフレッシュ表のトリガー・ログ領域を圧縮できます。「ttCacheAutorefreshLogDefrag」を参照してください。

リリース11.2.2.4.0の新機能

- ttRepAdmin -duplicate処理で、オプション-localIPおよび-remoteIPを使用して、複製の宛先にローカルIPアドレスまたはリモートIPアドレスを指定できるようになりました。「データベースの複製」を参照してください。

- 新しいIndex Advisorを使用して、特定のSQLワークロードのパフォーマンスを改善できる可能性のある索引に関する推奨を受け取ることができます。Index Advisorはいくつかの組込みプロシージャで構成されます。Index Advisorを構成するプロシージャは次のとおりです。

- ttIndexAdviceCaptureDrop

- ttIndexAdviceCaptureEnd

- ttIndexAdviceCaptureInfoGet

- ttIndexAdviceCaptureOutput

- ttIndexAdviceCaptureStart

- 新しいツールであるTimesTenキャッシュ・アドバイザを使用することで、Oracle Databaseの顧客が、TimesTen Cacheを使用した場合に既存のOracle Databaseアプリケーションのパフォーマンスを向上できるかどうかを判断できます。Cache Advisorは、Oracle DatabaseアプリケーションのSQL使用率に基づき、TimesTenキャッシュ・グループの定義の推奨値を生成します。詳細は、「ttCacheAdvisor」を参照してください。

- 結果を含めるためのキャッシュ・グリッド、キャッシュ・グループ、およびキャッシュ表を作成しないで、SQL問合せの結果をバックエンドのOracle DatabaseからTimesTenの単一表にロードできるようにする、新しいツールが追加されました。TimesTenには、ユーザーが指定するSELECT文をOracle Databaseで実行し、その結果セットをTimesTenの表にロードするツールが用意されています。ttIsqlユーティリティが機能拡張されてLoadFromOracleコマンドが含まれるようになりました。さらに、今回のリリースには2つの新しい組込みプロシージャがこの機能の一部として含まれています。

- ttLoadFromOracle

- ttTableSchemaFromOraQueryGet

リリース11.2.2.2.0の新機能

- ttIsqlユーティリティは、autovariables、set/show属性としてのshowcurrenttime、IFコマンドおよびWHENEVERによるエラー処理をサポートするようになりました。詳細は、ttIsqlユーティリティの説明を参照してください。

- 新しい自動パラレル・レプリケーションでは、パラレル・レプリケーションおよびトランザクションのアプリケーションによってレプリケーション・スキーム内の受信ノードを変更できるようになりました。パラレル・レプリケーションの詳細は、第1章「接続属性」を参照してください。

リリース11.2.2.1.0の新機能

- ttComputeTabSizes組込みプロシージャの使用により、表の現在の領域使用量を確認できる機能。

- 新しい自動パラレル・レプリケーションでは、パラレル・レプリケーションおよびトランザクションのアプリケーションによってレプリケーション・スキーム内の受信ノードを変更できるようになりました。パラレル・レプリケーションの詳細は、第1章「接続属性」を参照してください。

- AWTキャッシュ表の変更について、対応するOracle Database表へのパラレル伝播を構成できます。パラレル伝播の詳細は、第1章「接続属性」を参照してください。

- 64ビット・システムでは、LogBufMB接続属性およびLogFileSize接続属性の最大値が64GBに増えました。

1 接続属性

ODBC標準では、次の4つの接続属性を定義しています。

- DSN

- ドライバ

- UID

- PWD

これらの属性のODBC定義の説明については、使用しているプラットフォームのODBCマニュアルを参照してください。

- 『Microsoft ODBC 3.0 Programmer's Reference and SDK Guide』

- 『Microsoft ODBC 2.0 Programmer's Reference and SDK Guide』

この章では、TimesTenで定義されるすべての接続属性について説明します。接続文字列内に指定された属性の名前とほとんどの値を表示するために、アプリケーションはttConfiguration組込みプロシージャを使用できます。

注意:
ODBC標準に従うと、ある属性が接続文字列内に複数回出現する場合、指定されている最初の値が使用され、後続値は使用されません。

UNIXでは、Falseは属性値が0に設定されることを意味し、Trueは属性値が1に設定されることを意味します。

Windowsでは、Falseはチェック・ボックスが選択されないことを意味し、Trueはチェック・ボックスが選択されることを意味します。

次の項では、「List属性のリスト」の各表にリストしてあるTimesTenの属性について説明します。次の表に、各属性の詳細を説明します。

- 属性に必要な権限

- 属性のリスト

属性に必要な権限

初期接続属性の値を現在有効な値以外に変更できるのは、インスタンス管理者のみです。(ただし、AutoCreateおよびForceConnectの変更には権限は不要です。)

属性のリスト

この項では、次の表を示します。

- 表1-1「データ・ストア属性」

- 表1-2「初期接続属性」

- 表1-3「一般接続属性」

- 表1-4「NLS一般接続属性」

- 表1-5「PL/SQLの初期接続属性」

- 表1-6「PL/SQLの一般接続属性」

- 表1-7「TimesTen Cacheの初期接続属性」

- 表1-8「TimesTen Cacheのデータベース属性」

- 表1-9「TimesTen Cacheの一般接続属性」

- 表1-10「TimesTen Client接続属性」

- 表1-11「TimesTen Server接続属性」

表1-1 データ・ストア属性

名前

説明

デフォルト

Data Source Name

データベースへの接続の特定の属性を識別する名前。

なし

DataStore

物理データベースを指定します。

なし

DatabaseCharacterSet

データベースによって使用されるキャラクタ・セットを指定します。この属性はデータベースの作成時に必要です。

なし

Description

データ・ソース名の使用方法を指定するコメント。

なし

Driver

TimesTen ODBCドライバ・マネージャを指定します。

なし

LogDir

トランザクション・ログ・ファイルを保存するディレクトリ。

データベース・ディレクトリ

Preallocate

データベースの作成時に、データベースのディスク領域が事前に割り当てられることを指定します。

0 (False)

RangeIndexType

ユーザーが作成した範囲索引がTツリー索引であるかBツリー索引であるかを指定します。

1 (範囲索引はTツリー索引)

ReplicationApplyOrdering

自動またはユーザー指定の追跡ベース・パラレル・レプリケーションを有効にします。

0 (自動パラレル・レプリケーションの開始)

ReplicationParallelism

ユーザー指定のパラレル・レプリケーションで使用可能な追跡数を指定します。

1

Temporary

データベースがディスクに保存されないことを指定します。

0 (False)

TypeMode

データベースの型モード。

0 (Oracle型モード)

表1-2 初期接続属性

名前

説明

デフォルト

AutoCreate

初期接続時に、データベースが存在しない場合は作成することを指定します。

1 (True)

CkptFrequency

TimesTenがバックグラウンド・チェックポイントを実行する頻度を秒単位で制御します。

600

CkptLogVolume

バックグラウンド・チェックポイントの間にログに収集するデータ量をMB単位で制御します。

0 (オフ)

CkptRate

チェックポイント処理でデータをディスクに書き込むときの最大速度を制御します。

0 (速度制限なし)

CkptReadThreads

データベースをメモリーにロードする際にチェックポイント・ファイルの読取りに使用されるスレッドの数を制御します。

1

Connections

データベースへのユーザー指定の同時接続数の上限を示します。

2000未満またはSEMMSLカーネル・パラメータで指定されたセマフォの数

ForceConnect

障害が発生したデータベースが、対応するサブスクライバ・データベースから正常にリストアされなかった場合に、接続を許可するかどうかを指定します。

0 (接続が許可されない)

LogAutoTruncate

TimesTenリカバリでログ・レコードに問題が発生した場合、データベースへの初期接続を継続するかどうかを指定します。

1 (ログの切捨て後に継続)

LogBufMB

内部ログ・バッファのサイズ(MB単位)。

64

LogBufParallelism

ログ・バッファ・ストランドの数。

4

LogFileSize

トランザクション・ログ・ファイルのサイズ(MB単位)。

64

LogFlushMethod

TimesTenによってトランザクション・ログ・ファイルへのログ・データの書込みおよび同期化に使用される方法を制御します。

1 (バッファされた書込みを使用してトランザクション・ログ・ファイルにデータを書き込みます。必要に応じて明示的な同期化処理を使用してディスクへログ・データを同期化します)

LogPurge

チェックポイント処理で不要なトランザクション・ログ・ファイルが削除されることを指定します。

1 (True)

MemoryLock

共有データベースに接続しているアプリケーションが、データベースのロード中に実メモリーをロックするかどうかを指定します。

0 (メモリー・ロックを取得しない)

Overwrite

接続時に、既存のデータベースを新しいデータベースで上書きすることを指定します。

0 (False)

PermSize

データベースの永続パーティションのサイズ(MB単位)。

32

ReceiverThreads

アクティブ・スタンバイ・ペアのレプリケーション・スキームで、アクティブ・マスター・データベースへの変更をスタンバイ・マスター・データベースに適用するために使用するスレッドの数を制御します。

1

RecoveryThreads

リカバリ中に索引を再作成するために使用するスレッドの数。

1

TempSize

データベースの一時パーティションのサイズ(MB単位)。

PermSize値によって決定されるデフォルト・サイズ

表1-3 一般接続属性

名前

説明

デフォルト

CommitBufferSizeMax

トランザクション制御ブロックのコミット・バッファの最大サイズを指定します。

16KB

ConnectionName

データソースのシンボリック名が存在するかどうかを指定します。

プロセス名

DDLCommitBehavior

DDLに関連してトランザクションのコミット動作を制御します。

0 (Oracleの動作)

DDLReplicationAction

DDLReplicationLevel接続属性が2または3に設定されている場合にのみ、表または順序を、作成時にアクティブ・スタンバイ・ペアのレプリケーション・スキームに含めるかどうかを決定します。

INCLUDE

DDLReplicationLevel

アクティブ・スタンバイ・レプリケーション・スキーム内でのデータ定義言語(DDL)文のレプリケーションを有効にします。

2 (特定のオブジェクトのレプリケーションが有効)

Diagnostics

診断メッセージを生成するかどうかを指定します。

1 (メッセージが生成される)

DuplicateBindMode

1つのSQL文に同じパラメータが複数回出現する場合に、アプリケーションがTimesTenとOracleのいずれのパラメータ・バインディングを使用するかを指定します。

0 (Oracleスタイルのバインディング)

DurableCommits

コミット処理がログ・レコードをディスクに書き込むことを指定します。

0 (レコードがディスクに書き込まれない)

Isolation

分離レベルとして、コミット読取りまたはシリアライズ可能のいずれかを指定します。

1 (コミット読取り)

LockLevel

接続が行レベル・ロック(値=0)またはデータベース・レベル・ロック(値=1)のいずれを使用するかを指定します。

0 (行レベル・ロック)

LockWait

アプリケーションの接続中のロック待機時間を設定します。

10秒

MatchLogOpts

LogPurge属性に使用される値が現在の接続のそれらの値と一致することを指定します。

0 (False)

PermWarnThreshold

データベースの永続パーティションに対するメモリーが少ない場合、TimesTenが警告を返し、SNMPトラップをスローするしきい値。

90%

PrivateCommands

接続間でコマンドを共有するかどうかを指定します。

0 (オン)

PWD

「UIDおよびPWD」を参照してください。

指定されているUIDに対応するパスワードを指定します。Oracle Databaseからデータをキャッシュする場合、PWDはTimesTenパスワードを指定します。必要に応じて、接続文字列にOracle PWDを指定できます。

なし

PWDCrypt

暗号化されたユーザー・パスワードの値。

なし

QueryThreshold

問合せが実行前にタイムアウトした場合に、TimesTenが警告を返してSNMPトラップをスローするかどうかを指定します。

0 (警告を返さない)

ReplicationTrack

レプリケーション追跡に接続を割り当てます。

なし

SQLQueryTimeout

データベースがSQL文を実行する必要がある制限時間(秒単位)を指定します。

0 (タイムアウトなし)

TempWarnThreshold

データベースの一時パーティションに対するメモリーが少ない場合、TimesTenが警告を返し、SNMPトラップをスローするしきい値。

90 (パーセント)

UID

「UIDおよびPWD」を参照してください。

TimesTenサーバー上で定義されているユーザー名を指定します。Oracle Databaseからデータをキャッシュする場合、このUIDが、TimesTenにキャッシュされているOracle Database上のUIDと一致する必要があります。

なし

WaitForConnect

即時に接続できない場合、接続の試行を待機することを指定します。

1

表1-4 NLS一般接続属性

名前

説明

デフォルト

ConnectionCharacterSet

接続の文字エンコードを指定します。データベースのキャラクタ・セットとは異なる場合があります。

データベースのキャラクタ・セットがTIMESTEN8の場合はTIMESTEN8で、それ以外はUS7ASCII

NLS_LENGTH_SEMANTICS

デフォルトの長さセマンティクス構成。

BYTE

NLS_NCHAR_CONV_EXCP

NCHAR/NVARCHARデータとCHAR/VARCHARデータの間で暗黙的または明示的なキャラクタ・タイプの変換が行われる際、データ損失が発生した場合にエラーを報告するかどうかを指定します。

0 (False)

NLS_SORT

言語比較に使用される照合順番。

BINARY

表1-5 PL/SQLの初期接続属性

名前

説明

デフォルト

PLSQL

PL/SQLを有効または無効にします。

1 (PL/SQLが有効)

PLSQL_MEMORY_ADDRESS

共有メモリー・セグメントが、TimesTenダイレクト・ドライバを利用する各プロセスにロードされる仮想アドレス。

プラットフォーム固有

PLSQL_MEMORY_SIZE

PL/SQLで使用される共有メモリー・セグメントのサイズ(MB単位)。

32MB

表1-6 PL/SQLの一般接続属性

名前

説明

デフォルト

PLSCOPE_SETTINGS

PL/SQLコンパイラで相互参照情報を生成するかどうかを制御します。

IDENTIFIERS: NONE

PLSQL_CCFLAGS

PL/SQLユニットの条件付きコンパイルを制御します。

NULL

PLSQL_CONN_MEM_LIMIT

この接続でPL/SQLが使用できるプロセス・ヒープ・メモリーの最大量をMB単位で指定します。

100

PLSQL_OPTIMIZE_LEVEL

PL/SQLコンパイラがPL/SQLライブラリ・ユニットのコンパイルに使用する最適化レベル。

2

PLSQL_TIMEOUT

PL/SQLプロシージャが自動的に終了されるまでの実行時間(秒数)。

30秒

表1-7 TimesTen Cacheの初期接続属性

名前

説明

デフォルト

CacheAWTMethod

Oracle Database表で使用されるAWT伝播方法を有効にします。

1 (PL/SQL)

表1-8 TimesTen Cacheのデータベース属性

名前

説明

デフォルト

CacheAWTParallelism

Oracle Databaseに変更を適用するために必要なスレッドの数を示します。

1

CacheGridEnable

キャッシュ・グリッドを有効にします。

1 (有効)

CacheGridMsgWait

メッセージの最大待機時間を秒単位で設定します。

60

表1-9 TimesTen Cacheの一般接続属性

名前

説明

デフォルト

DynamicLoadEnable

Oracle Databaseから動的キャッシュ・グループへのデータの透過的ロードを有効または無効にします。

1 (動的キャッシュ・グループのロードが有効)

DynamicLoadErrorMode

透過的ロードに失敗した場合にエラー・メッセージを返すかどうかを指定します。

0(エラーを返さない)

OracleNetServiceName

TimesTenデータベースにデータをロードするOracle DatabaseインスタンスのOracleサービス名。この属性は、キャッシュ・エージェントによってのみ使用されます。OracleNetServiceName属性はOracleサービス名に設定してください。

なし

OraclePWD

TimesTenにキャッシュされるOracle Databaseのパスワードを指定します。

なし

PassThrough

TimesTenでローカルで実行されるSQL文、およびOracle Databaseに渡されて実行されるSQL文を指定します。

0

RACCallback

アプリケーション・フェイルオーバー(TAF)および高速アプリケーション通知(FAN)のコールバックのインストールを有効または無効のいずれにするかを指定します。

1(コールバックをインストールする)

表1-10 TimesTen Client接続属性

名前

説明

デフォルト

TCP_Port

TimesTenサーバーがリスニングするポート番号。

なし

TCP_Port2

自動フェイルオーバーが発生したときにTimesTenサーバーがリスニングするポート番号。

なし

TTC_FailoverPortRange

フェイルオーバー・ポート番号の範囲。

なし

TTC_Server

TimesTen Serverが実行しているコンピュータの名前または論理TimesTen Server名。

なし

TTC_Server2

自動フェイルオーバーが発生したときにTimesTen Serverを実行するコンピュータの名前または論理TimesTenサーバー名。

なし

TTC_Server_DSN

TimesTenデータベースに対応するサーバーDSN。

なし

TTC_Server_DSN2

自動フェイルオーバーが発生したときのTimesTenデータベースに対応するサーバーDSN。

なし

TTC_Timeout

オプション。TimesTen Client/Serverの操作の完了に対するタイムアウト時間(秒単位)。

60

表1-11 TimesTen Server接続属性

名前

説明

デフォルト

MaxConnsPerServer

子TimesTenサーバー・プロセスが処理できる最大同時接続数。

1

ServersPerDSN

DSNに指定するTimesTenサーバー・プロセス数。

1

ServerStackSize

各接続のスレッド・スタックのサイズ(KB単位)。

128 (32ビット・システム)

256 (64ビット・システム)

データ・ストア属性

データ・ストア属性は、データ・ストアの作成時に設定されます。この項では、表1-1「データ・ストア属性」にリストしたデータ・ストア属性について説明します。

これらの属性には、データベースの作成時にインスタンス管理者のみが値を割り当てることができます。

データ・ソース名

データ・ソース名(DSN)は接続への属性を一意に識別します。これは次の2つの目的に役立ちます。

- ODBCドライバ・マネージャの一意の識別子(存在する場合)として、データ・ストア名を特定のODBCドライバに関連付けます。

- 別名に一意の属性が関連付けられている1つの物理データベースに対する(場合によっては多数の)別名の1つとして使用します。

データベース属性は、データソース名(データベースへの接続)またはデータ・ストア・パス名(データベース)のいずれかに適用できます。

Windowsでは、データソース名およびデータソースに関連付けられたすべての設定情報(データベース・パス名など)は、システムのレジストリに格納されます。ODBCドライバ・マネージャとTimesTenはこの情報を使用します。

必要な権限

インスタンス管理者のみがこの属性の値を変更できます。

設定

Data Source Nameは次のように設定します。

属性の設定場所

属性の表示

設定

CまたはJavaプログラム、あるいはUNIX odbc.iniファイル

DSN

DSNを表す名前。

Windows ODBCデータソース・アドミニストレータ

「Data Source Name」フィールド

DSNを表す名前。

DataStore

データベース・パス名は物理データベースを一意に識別します。これはデータベースのフル・パス名とファイル名の接頭辞であり、たとえばC:\data\AdminDataとなります。この名前はファイル名ではありません。実際のデータベース・ファイルの名前は、たとえばC:\data\AdminData.ds0やC:\data\AdminData.log0のように.ds0や.log0などの接頭辞で示されます。

注意:
データベースの作成時にデータベースのパスと名前を指定する必要があります。データベースを作成した後は変更できません。

必要な権限

インスタンス管理者のみがこの属性の値を変更できます。

設定

DataStoreは次のように設定します。

属性の設定場所

属性の表示

設定

CまたはJavaプログラム、あるいはUNIX odbc.iniファイル

DataStore

データソース名が参照している物理的なデータベースのフルパスです。

Windows ODBCデータソース・アドミニストレータ

「Data Store Path + Name」フィールド

データソース名が参照している物理的なデータベースのフルパスです。

DatabaseCharacterSet

データベースのキャラクタ・セットにより、データを格納する際のキャラクタ・セットが決定されます。

注意:
データベースの作成時のみにデータベースのキャラクタ・セットを指定する必要があります。データベースを作成した後は変更できません。データベースの作成時にこの属性の値を指定しないと、TimesTenはエラー・メッセージ12701を返します。

通常、データ要件に基づいて、データベースのキャラクタ・セットを選択する必要があります。たとえば、データをUnicodeで使用するか、UNIX(EUC)またはWindows(SJIS)上で日本語として使用するかを選択します。

ご使用の端末の設定またはデータソースと一致する接続キャラクタ・セットを選択する必要があります。「ConnectionCharacterSet」を参照してください。

データベースのキャラクタ・セットと接続キャラクタ・セットが異なる場合、TimesTenは、接続キャラクタ・セットに従って内部的にデータを変換します。接続およびデータベースのキャラクタ・セットが同じ場合、TimesTenはデータ・セットを変換したり解釈する必要はありません。接続およびデータベースのキャラクタ・セットが一致していると、変換の必要がないため、最高のパフォーマンスを得られます。

この属性を使用するには、サポートされているキャラクタ・セットを指定してください。サポートされるキャラクタ・セット名のリストは、次の「サポートされているキャラクタ・セット」を参照してください。

データベースのキャラクタ・セットを選択する場合、いくつかの考慮事項があります。これらの考慮事項については、『Oracle TimesTen In-Memory Databaseオペレーション・ガイド』のデータベース・キャラクタ・セットの選択に関する説明を参照してください。

必要な権限

インスタンス管理者のみがこの属性の値を変更できます。

設定

DatabaseCharacterSet名は次のように設定します。

属性の設定場所

属性の表示

設定

CまたはJavaプログラム、あるいはUNIX odbc.iniファイル

DatabaseCharacterSet

優先キャラクタ・セットを指定します。

Windows ODBCデータソース・アドミニストレータ

データベースのキャラクタ・セットのリスト

ODBCデータソース・アドミニストレータで指定されたリストから、優先キャラクタ・セットを選択します。

サポートされているキャラクタ・セット

この項の各表では、TimesTenでサポートされているキャラクタ・セットを示します。

アジア言語のキャラクタ・セット

名前

説明

JA16EUC

EUC 24ビットの日本語

JA16EUCTILDE

JA16EUCと同じですが、Unicodeとの間で波ダッシュとチルダをマップする方法は異なります。

JA16SJIS

Shift-JIS 16ビットの日本語

JA16SJISTILDE

JA16SJISと同じですが、Unicodeとの間で波ダッシュとチルダをマップする方法は異なります。

KO16KSC5601

KSC5601 16ビットの韓国語

KO16MSWIN949

Microsoft Windowsコード・ページ949の韓国語。

TH8TISASCII

タイ工業規格620-2533 ASCII 8ビット。

VN8MSWIN1258

Microsoft Windowsコード・ページ1258の8ビットのベトナム語。

ZHS16CGB231280

CGB2312-80 16ビットの簡体字中国語

ZHS16GBK

GBK 16ビットの簡体字中国語

ZHS32GB18030

GB18030-2000

ZHT16BIG5

BIG5 16ビット繁体字中国語

ZHT16HKSCS

香港増補キャラクタ・セットHKSCS-2001を使用したMicrosoft Windowsコード・ページ950。Unicodeとの間のキャラクタ・セット変換は、Unicode 3.0に基づきます。

ZHT16MSWIN950

Microsoft Windowsコード・ページ950の繁体字中国語。

ZHT32EUC

EUC 32ビットの繁体字中国語

ヨーロッパ言語のキャラクタ・セット

名前

説明

BLT8CP921

ラトビア語標準LVS8-92(1)Windows/UNIX 8ビットのバルト語

BLT8ISO8859P13

ISO 8859-13のバルト語。

BLT8MSWIN1257

Microsoft Windowsコード・ページ1257の8ビットのバルト語。

BLT8PC775

IBM-PCコード・ページ775の8ビットのバルト語。

CEL8ISO8859P14

ISO 8859-13のケルト語。

CL8ISO8859P5

ISO 8859-5のラテン語/キリル語。

CL8KOI8R

RELCOMインターネット標準の8ビットのラテン語/キリル語。

CL8KOI8U

KOI8キリル語(ウクライナ)。

CL8MSWIN1251

Microsoft Windowsコード・ページ1251の8ビットのラテン語/キリル語。

EE8ISO8859P2

ISO 8859-2の東ヨーロッパ言語。

EL8ISO8859P7

ISO 8859-7のラテン語/ギリシャ語。

ET8MSWIN923

Microsoft Windowsコード・ページ923の8ビットのエストニア語。

EE8MSWIN1250

Microsoft Windowsコード・ページ1250の8ビットの東ヨーロッパ言語。

EL8MSWIN1253

Microsoft Windowsコード・ページ1253の8ビットのラテン語/ギリシャ語。

EL8PC737

IBM-PCコード・ページ737の8ビットのギリシャ語/ラテン語。

EE8PC852

IBM-PCコード・ページ852の8ビットの東ヨーロッパ言語。

LT8MSWIN921

Microsoft Windowsコード・ページ921の8ビットのリトアニア語。

NE8ISO8859P10

ISO 8859-10の北ヨーロッパ言語。

NEE8ISO8859P4

ISO 8859-4の北および北東ヨーロッパ言語。

RU8PC866

IBM-PCコード・ページ866の8ビットのラテン語/キリル語。

SE8ISO8859P3

ISO 8859-3の南ヨーロッパ言語。

US7ASCII

ASCII 7ビットの米語。

US8PC437

IBM-PCコード・ページ437の8ビットの米語。

WE8ISO8859P1

ISO 8859-1の西ヨーロッパ言語。

WE8ISO8859P15

ISO 8859-15の西ヨーロッパ言語。

WE8MSWIN1252

Microsoft Windowsコード・ページ1252の8ビットの西ヨーロッパ言語。

WE8PC850

IBM-PCコード・ページ850の8ビットの西ヨーロッパ言語。

WE8PC858

IBM-PCコード・ページ858の8ビットの西ヨーロッパ言語。

中東言語のキャラクタ・セット

名前

説明

AR8ADOS720

アラビア語MS-DOS 720 Serverの8ビットのラテン語/アラビア語。

AR8ASMO8X

ASMO拡張708の8ビットのラテン語/アラビア語。

AR8ISO8859P6

ISO 8859-6のラテン語/アラビア語。

AR8MSWIN1256

Microsoft Windowsコード・ページ1256の8ビットのラテン語/アラビア語。

AZ8ISO8859P9E

ISO 8859-9のラテン語/アゼルバイジャン語。

IW8ISO8859P8

ISO 8859-8のラテン語/ヘブライ語。

IW8MSWIN1255

Microsoft Windowsコード・ページ1255の8ビットのラテン語/ヘブライ語。

TR8MSWIN1254

Microsoft Windowsコード・ページ1254の8ビットのトルコ語。

TR8PC857

IBM-PCコード・ページ857の8ビットのトルコ語。

WE8ISO8859P9

ISO 8859-9の西ヨーロッパ言語とトルコ語。

TimesTenのキャラクタ・セット

名前

説明

TIMESTEN8

TimesTenのレガシー・キャラクタ・セマンティクス。

ユニバーサル・キャラクタ・セット

名前

説明

AL16UTF16

Unicode 4.0 UTF-16のユニバーサル・キャラクタ・セット。暗黙のTimesTen各国語キャラクタ・セットです。

AL32UTF8

Unicode 4.0 UTF-8のユニバーサル・キャラクタ・セット。

UTF8

Unicode 3.0 UTF-8のユニバーサル・キャラクタ・セット(CESU-8準拠)。

説明

データソース名(DSN)とその属性を識別しやすくするための属性です(オプション)。

必要な権限

インスタンス管理者のみがこの属性の値を変更できます。

設定

Descriptionは次のように設定します。

属性の設定場所

属性の表示

設定

CまたはJavaプログラム、あるいはUNIX odbc.iniファイル

Description

データソース名を説明するテキストです。この属性はオプションです。

Windows ODBCデータソース・アドミニストレータ

「Description」フィールド

データソース名を説明するテキストです。この属性はオプションです。

Driver

Driver属性はTimesTen ODBCドライバの名前を指定します。

たとえば、Windowsシステムの場合、値はTimesTen Data Manager 11.2.2またはTimesTen Client 11.2.2にできます。UNIXシステムの場合、Driver属性の値はTimesTen ODBCドライバの共有ライブラリ・ファイルのパス名です。このファイルは、stall_dir/libディレクトリにあります。

必要な権限

インスタンス管理者のみがこの属性の値を変更できます。

設定

Driverを次のように設定します。

属性の設定場所

属性の表示

設定

CまたはJavaプログラム、あるいはUNIX odbc.iniファイル

Driver

TimesTen ODBCドライバの共有ライブラリ・ファイルのパス名を指定します。

Windows ODBCデータソース・アドミニストレータ

「Create New Data Source」ダイアログから、ドライバを選択します。

TimesTenおよびそのリリースのクライアントまたはデータ・マネージャ用のドライバを指定します。

LogDir

LogDir属性では、データベースのログが存在するディレクトリを指定します。この属性を指定すると、データベースのチェックポイント・ファイルとは別のI/Oパスにトランザクション・ログ・ファイルを配置できます。これにより、スループットが向上します。

必要な権限

インスタンス管理者のみがこの属性の値を変更できます。

設定

LogDirは次のように設定します。

属性の設定場所

属性の表示

設定

CまたはJavaプログラム、あるいはUNIX odbc.iniファイル

LogDir

トランザクション・ログ・ファイルが存在するディレクトリを指定します。

Windows ODBCデータソース・アドミニストレータ

「Transaction Log Directory」フィールド

トランザクション・ログ・ファイルが存在するディレクトリを指定します。

Preallocate

Preallocate属性では、データベースの作成時にTimesTenがデータベース用にファイル・システムの領域を事前割当てするかどうかを決定します。この属性を設定すると、データベースをファイル・システムに保存するときに、データベース用に十分な領域が保証されます。

Preallocate=1を指定してttRestoreまたはttRepAdmin -duplicateを使用する場合、PermSizeの値と元のデータベースのPermSizeの値が異なっていると、サイズが異なるチェックポイント・ファイルが2つ生成されることがあります。このことが何かに悪影響を与えることはありません。ただし、この問題は、使用するPermSizeを元のデータベースと同じにするかまたはPreallocate=0に設定することで完全に回避できます。

複製処理が実行された場合、複製されたデータベースの動作は、元のデータベースまたは複製されたデータベースのPreallocateが1に設定されていても、Preallocateを0に設定したときと同じになります。動作はチェックポイント・ファイルのサイズ(データのサイズとデータベース・ヘッダーのサイズの合計)によって決定されます。

チェックポイント・ファイルは、その後マスター・データベースのチェックポイント・ファイルと同じサイズ(PermSizeとデータベース・ヘッダーの合計)まで大きくなることが可能ですが、領域は事前に割り当てられていません。チェックポイント・ファイルのサイズは、データの追加に伴い大きくなります。

PreAllocateはデータベース作成時に設定されるために、このような動作になります。これは初期接続属性ではありません。複製処理はデータベースの作成処理ではないため、Preallocate属性は適用されません。

必要な権限

インスタンス管理者のみがこの属性の値を変更できます。

設定

Preallocateは次のように設定します。

属性の設定場所

属性の表示

設定

CまたはJavaプログラム、あるいはUNIX odbc.iniファイル

Preallocate

0(デフォルト): データベースの作成時にデータベース用にファイル・システムの領域を事前割当てしません。
1: データベース用にファイル・システムの領域を事前割当てします。

Windows ODBCデータソース・アドミニストレータ

「Preallocate」チェック・ボックス

選択解除(デフォルト): データベースの作成時にデータベース用にファイル・システムの領域を事前割当てしません。
選択: データベース用にファイル・システムの領域を事前割当てします。

注意:
大きなデータベースのディスク領域の再割当てには長時間かかる場合があります。

RangeIndexType

RangeIndexType属性は、ユーザーが作成した範囲索引がTツリー索引を使用するかBツリー索引を使用するかを指定します。

注意:
0に設定されたRangeIndexTypeでデータベースが作成されると、11.2.2.5.0リリースより前のTimesTenでこのデータベースを使用できなくなります。

索引の詳細は、『Oracle TimesTen In-Memory Databaseオペレーション・ガイド』の索引の種類の概要に関する説明を参照してください。

必要な権限

インスタンス管理者のみがこの属性の値を変更できます。

設定

RangeIndexTypeは次のように設定します。

属性の設定場所

属性の表示

設定

CまたはJavaプログラム、あるいはUNIX odbc.iniファイル

RangeIndexType

0: ユーザーが作成したすべての範囲索引がBツリー索引になります。
1 (デフォルト): ユーザーが作成したすべての範囲索引がTツリー索引を使用します。

Windows ODBCデータソース・アドミニストレータ

「Range Index Type」フィールド

B-tree: ユーザーが作成したすべての範囲索引がBツリー索引になります。
T-tree (デフォルト): ユーザーが作成したすべての範囲索引がTツリー索引を使用します。

ReplicationApplyOrdering

ReplicationParallelism属性とともに使用すると、パラレル・レプリケーションが有効になります。パラレル・レプリケーションを使用すると、マスター上の複数のトランスミッタがサブスクライバ上の複数のレシーバに送信します。

- 自動パラレル・レプリケーション: トランザクションの依存性が自動的に強制され、すべての変更がコミット順に適用される、複数のスレッドにわたるパラレル・レプリケーション。これはデフォルトです。

- コミット依存性が無効化された自動パラレル・レプリケーション: トランザクションの依存性が自動的に強制されるが、サブスクライバ・データベース上とアクティブ・データベース上でトランザクションのコミット順序が同じであることが強制されない、複数のスレッドにわたるパラレル・レプリケーション。特定の追跡にトランザクションを適用することで、レプリケーションのスループットを向上させることもできます。

- ユーザー定義のパラレル・レプリケーション: クラシック・レプリケーション・スキームを使用し、トランザクションの依存性が高いと予測され、レシーバと元のデータベースのコミット順序が同じである必要がないアプリケーション向け。トランザクション追跡の数を指定し、各追跡に特定のトランザクションを適用することで、レプリケーションのスループットを向上させることができます。すべての追跡の読取り、送信および適用はパラレルに行われます。

パラレル・レプリケーションの構成の詳細は、『Oracle TimesTen In-Memory Database開発者および管理者ガイド』のパラレル・レプリケーションの構成に関する項を参照してください。

この属性はAWTキャッシュ・グループのパラレル伝播も設定します。デフォルトでは、この属性はOracle Databaseへの更新のパラレル伝播を有効化します。パラレルAWTキャッシュの詳細は、『Oracle TimesTen Application-Tier Database Cacheユーザーズ・ガイド』のOracle Database表へのパラレル伝播の構成に関する説明を参照してください。

必要な権限

インスタンス管理者のみがこの属性の値を変更できます。

設定

ReplicationApplyOrderingは次のように設定します。

属性の設定場所

属性の表示

設定

CまたはJavaプログラム、あるいはUNIX odbc.iniファイル

ReplicationApplyOrdering

0: 自動パラレル・レプリケーションを指定します。自動パラレル・レプリケーションは、クラシック・レプリケーション・スキームとアクティブ・スタンバイ・ペア・レプリケーション・スキームの両方で使用できます。(デフォルト)
1: ユーザー指定の追跡ベース・パラレル・レプリケーションを指定します。ユーザー定義のパラレル・レプリケーションは、クラシック・レプリケーション・スキームでのみ使用できます。

2 - コミット依存性が無効化された自動パラレル・レプリケーションを指定します。

Windows ODBCデータソース・アドミニストレータ

「Replication Apply Ordering」プルダウン・リスト

0: 自動パラレル・レプリケーションを指定します。自動パラレル・レプリケーションは、クラシック・レプリケーション・スキームとアクティブ・スタンバイ・ペア・レプリケーション・スキームの両方で使用できます。(デフォルト)
1: ユーザー指定の追跡ベース・パラレル・レプリケーションを指定します。ユーザー定義のパラレル・レプリケーションは、クラシック・レプリケーション・スキームでのみ使用できます。

2 - コミット依存性が無効化された自動パラレル・レプリケーションを指定します。

Restrictions

コミット依存性が無効化された自動パラレル・レプリケーションを使用する場合の制限は、次のとおりです。

- レプリケーション・スキームは、非同期レプリケーションを使用するアクティブ・スタンバイ・ペアである必要があります。クラシック・レプリケーション・スキームはサポートされていません。

- レプリケーション・スキームにはキャッシュ・グループを含めることはできません。

- これがサポートされるのは、アクティブとスタンバイの両方のマスターがTimesTenリリース11.2.2.8以降の場合のみです。アクティブとスタンバイの両方のマスターでは、コミット依存性が無効化されている必要があります。

- XLAはサポートされていません。

レプリケーション・スキーム内のすべてのデータ・ストアが同じ設定を使用している必要があります。

アクティブ・スタンバイ・ペアはユーザー定義のパラレル・レプリケーションを使用できません。

ReplicationParallelism

この属性は、パラレル・レプリケーションで使用する追跡数またはトランスミッタ/レシーバ・ペアの数を指定します。

この属性のデフォルトは1です。この値は単一スレッド・レプリケーションの発生を示します。この値が1より大きい場合、LogBufParallelism 初期接続属性はReplicationParallelismの整数倍である必要があります。

パラレル・レプリケーションを構成するには、この属性の値をトランスミッタ/レシーバ・ペアの数を示す2から32に設定します。

CacheAWTParallelism属性が1に設定されているか設定されていない場合、ReplicationParallelismで許容される最大値は16です。

パラレル・レプリケーションの詳細は、『Oracle TimesTen In-Memory Database開発者および管理者ガイド』のパラレル・レプリケーションの構成に関する説明を参照してください。

必要な権限

インスタンス管理者のみがこの属性の値を変更できます。

設定

ReplicationParallelismは次のように設定します。

属性の設定場所

属性の表示

設定

CまたはJavaプログラム、あるいはUNIX odbc.iniファイル

ReplicationParallelism

n: 1から32までの値で、パラレルでレプリケートする追跡の数を示します。デフォルトは1で、単一スレッド・レプリケーションです。

Windows ODBCデータソース・アドミニストレータ

「Replication Parallelism」フィールド

n: 1から32までの値で、パラレルでレプリケートする追跡の数を示します。デフォルトは1で、単一スレッド・レプリケーションです。

Restrictions

パラレル・レプリケーションを指定する場合の制限および注意事項は、次のとおりです。

- パラレル・レプリケーションが有効な場合、ttLogHolds組込みプロシージャのDescription列には、サブスクライバ・ノードごとに追跡が1行に表示されます。

- この属性の値は、LogBufParallelism属性の値の半分以下であることを推奨します。ログ・バッファのスレッドより多くのレプリケーション追跡を指定した場合、一部のレプリケーション追跡は空のままになります。

- TWOSAFEレプリケーションおよびRETURN RECEIPTレプリケーションを含む同期レプリケーションは、ユーザー指定のパラレル・レプリケーションではサポートされていません。

- アクティブ・スタンバイ・ペアはユーザー指定のパラレル・レプリケーションではサポートされていません。

- コミット依存性が無効化されたパラレル・レプリケーションは、ユーザー定義のパラレル・レプリケーションではサポートされていません。

Temporary

一時データベースを作成するには、この属性を設定します。一時データベースはファイル・システムに保存されません。ただし、一時データ・ストアは共有される場合があるため、データ・ストア・パス名が必要です。最後の接続の切断時に、一時データベースは削除されます。詳細は、『Oracle TimesTen In-Memory Databaseオペレーション・ガイド』のデータベースの永続性に関する説明を参照してください。Temporaryデータ・ストア属性を既存の永続データベースに割り当てることはできません。

注意:
一時データベースはバックアップまたはレプリケートできません。

必要な権限

インスタンス管理者のみがこの属性の値を変更できます。

設定

Temporaryは次のように設定します。

属性の設定場所

属性の表示

設定

CまたはJavaプログラム、あるいはUNIX odbc.iniファイル

Temporary

0 (デフォルト): 永続データベースが作成されます。
1: 一時データベースが作成されます。

Windows ODBCデータソース・アドミニストレータ

「Temporary」チェック・ボックス

選択解除 (デフォルト): 永続データベースが作成されます。
選択: 一時データベースが作成されます。

TypeMode

データ型の名前と意味がOracleまたはTimesTen型の規則に従うかどうかを指定します。TimesTenは、OracleとTimesTenのデータ型をサポートします。データ型モードによって、各データ型を指定するときに使用する名前が決定します。場合によっては、データ型には別名と固定型の両方の名前があります。このような場合、いずれの名前も使用できます。TimesTen型モードは下位互換用に含まれています。DSNを作成する場合は、デフォルト設定のOracleタイプ・モードを使用します。

TimesTenでOracle Databaseからデータをキャッシュする場合、TypeModeは0に設定する必要があります。

データ型とその固定名および別名のリストについては、『Oracle TimesTen In-Memory Database SQLリファレンス・ガイド』のデータ型の仕様に関する説明を参照してください。

必要な権限

インスタンス管理者のみがこの属性の値を変更できます。

設定

TypeModeは次のように設定します。

属性の設定場所

属性の表示

設定

CまたはJavaプログラム、あるいはUNIX odbc.iniファイル

TypeMode

0 (デフォルト): Oracle型モード
1 - TimesTen型モード

値が指定されていない場合は、デフォルトの型モードまたはデータベースの作成時に割り当てられた型モードが使用されます。

Windows ODBCデータソース・アドミニストレータ

「TypeMode」ドロップダウン・リスト

0 (デフォルト): Oracle型モード
1 - TimesTen型モード

値が指定されていない場合は、デフォルトの型モードまたはデータベースの作成時に割り当てられた型モードが使用されます。

初期接続属性

初期接続属性は、アイドル状態のデータベース(現在接続されていない、インスタンス管理者によって作成されたデータベース)に接続すると設定され、このデータベースへの最後の接続がクローズされるまで、その接続およびその後のすべての接続に対して有効です。

この項では、表1-2「初期接続属性」に示した初期接続属性について説明します。

初期接続属性の設定と異なる属性を使用してデータベースに接続しようとした場合、新しい接続が拒否されるか、属性値が無視されることがあります。ただし、既存の接続であるサイズのLogFileSizeを指定した後に、新しい接続で別のサイズのLogFileSizeを指定すると、TimesTenは新しい値を無視して警告を返します。

注意:
初期接続属性の値を現在有効な値以外に変更できるのは、インスタンス管理者のみです。初期接続属性の値を変更するには、最初にデータベースを停止してからADMIN権限で接続する必要があります。(ただし、AutoCreateおよびForceConnectの変更には権限は不要です。)

AutoCreate

AutoCreate属性が設定されているデータベースに接続する場合、そのデータベースがまだ存在していなくても、有効な既存のパスを指定しておくと、データベースが自動的に作成されます。AutoCreateを設定すると、TimesTenではデータベースへのパスではなく、データベースが作成されます。AutoCreate属性が設定されていない場合に、存在しないデータベースに接続しようとすると、接続は失敗します。

「Overwrite」も参照してください。

必要な権限

この属性の値の変更に権限は必要ありません。

設定

AutoCreateは次のように設定します。

属性の設定場所

属性の表示

設定

CまたはJavaプログラム、あるいはUNIX odbc.iniファイル

AutoCreate

0: データベースが存在しない場合、新しいデータベースは作成されません。
1 (デフォルト): 指定したデータベースが存在しない場合、新しいデータベースが作成されます。

Windows ODBCデータソース・アドミニストレータ

「AutoCreate」チェック・ボックス

選択解除: データベースが存在しない場合、新しいデータベースは作成されません。
選択(デフォルト): データベースが存在しない場合、新しいデータベースが作成されます。

CkptFrequency

TimesTenがバックグラウンド・チェックポイントを実行する頻度を秒単位で制御します。チェックポイントの条件に使用されるカウンタは、各チェックポイントの開始時にリセットされます。

CkptFrequencyとCkptLogVolumeの両方の属性が0より大きい値に指定されている場合、チェックポイントは2つの条件のいずれかがTrueになったときに実行されます。ttCkptConfig組込みプロシージャによって設定される値は、これらの属性によって設定される値を置換します。

バックグラウンド・チェックポイントの進行中にアプリケーションでチェックポイント処理の実行を試みる場合、TimesTenは、バックグラウンド・チェックポイントが終了するまで待機してから、アプリケーションのチェックポイントを実行します。バックグラウンド・チェックポイントを無効にするには、CkptFrequency=0およびCkptLogVolume=0を設定します。

この属性の値は「スティッキー」で、値が明示的に変更されないかぎり、データベースのロードからアンロードまで維持されます。デフォルト値はデータベースの作成中にのみ使用されます。後続の初期接続では、データベースに保存された既存の値がデフォルトで使用されます。

この属性の値にかかわらず、チェックポイントが失敗した場合、TimesTenは10分に一度だけチェックポイント処理を試行します。システム領域の不足のためにチェックポイントの失敗が発生した場合、領域が使用可能になり次第、手動でチェックポイント処理を実行することをお薦めします。チェックポイントが成功した後は、バックグラウンド・チェックポイント処理は設定したスケジュールに戻ります。

必要な権限

インスタンス管理者のみがこの属性の値を変更できます。

設定

CkptFrequencyは次のように設定します。

属性の設定場所

属性の表示

設定

CまたはJavaプログラム、あるいはUNIX odbc.iniファイル

CkptFrequency

TimesTenがバックグラウンド・チェックポイントを実行する頻度を秒単位で入力します。デフォルトは600です。
この属性を指定しない場合、TimesTenはデータベースの作成にデフォルト値(600)を使用します。既存のデータベースに対しては、TimesTenは保存された値を使用します。

属性を指定しても値を指定しない場合には、値0が使用されます。

-1の値を指定すると、この属性を省略したことになります。-1の値を指定した場合、データベースの作成にデフォルト値(600)が使用され、それ以外の場合は保存された値が使用されます。

Windows ODBCデータソース・アドミニストレータ

「Ckpt Frequency (secs)」フィールド

TimesTenがバックグラウンド・チェックポイントを実行する頻度を秒単位で入力します。デフォルトは600です。
この属性を指定しない場合、TimesTenはデータベースの作成にデフォルト値(600)を使用します。既存のデータベースに対しては、TimesTenは保存された値を使用します。

属性を指定しても値を指定しない場合には、値0が使用されます。

CkptLogVolume

バックグラウンド・チェックポイントの間にログに収集するデータ量をMB単位で制御します。チェックポイントの条件に使用されるカウンタは、各チェックポイントの開始時にリセットされます。

CkptFrequencyとCkptLogVolumeの両方の属性が0より大きい値に指定されている場合、チェックポイントは2つの条件のいずれかがTrueになったときに実行されます。ttCkptConfig組込みプロシージャによって設定される値は、これらの属性によって設定される値を置換します。

バックグラウンド・チェックポイントの進行中にアプリケーションでチェックポイント処理の実行を試みる場合、TimesTenは、バックグラウンド・チェックポイントが終了するまで待機してから、アプリケーションのチェックポイントを実行します。バックグラウンド・チェックポイントを無効にするには、CkptFrequency=0およびCkptLogVolume=0を設定します。

この属性の値は「スティッキー」で、値が明示的に変更されないかぎり、データベースのロードからアンロードまで維持されます。デフォルト値はデータベースの作成中にのみ使用されます。後続の初期接続では、データベースに保存された既存の値がデフォルトで使用されます。

必要な権限

インスタンス管理者のみがこの属性の値を変更できます。

設定

CkptLogVolumeは次のように設定します。

属性の設定場所

属性の表示

設定

CまたはJavaプログラム、あるいはUNIX odbc.iniファイル

CkptLogVolume

バックグラウンド・チェックポイント間でトランザクション・ログ・ファイルに蓄積されるデータ量をMB単位で指定します。デフォルトは0です。
この属性を指定しない場合、TimesTenはデータベースの作成にデフォルト値(0)を使用します。既存のデータベースに対しては、TimesTenは保存された値を使用します。

属性を指定しても値を指定しない場合には、TimesTenはデフォルト値(0)を使用します。

-1の値を指定すると、この属性を省略したことになります。-1の値を指定した場合、TimesTenはデータベースの作成にデフォルト値(0)を作成します。データベースがすでに存在している場合には、TimesTenは保存された値を使用します。

Windows ODBCデータソース・アドミニストレータ

「Ckpt LogVolume」フィールド

バックグラウンド・チェックポイント間でトランザクション・ログ・ファイルに蓄積されるデータ量をMB単位で指定します。デフォルトは0です。
この属性を指定しない場合、TimesTenはデータベースの作成にデフォルト値(0)を使用します。既存のデータベースに対しては、TimesTenは保存された値を使用します。

属性を指定しても値を指定しない場合には、TimesTenはデフォルト値(0)を使用します。

CkptRate

チェックポイント処理でデータをディスクに書き込むときの最大速度を制御します。この属性は、ディスクへのチェックポイントの書込みが、他のアプリケーションに支障をきたすような場合に使用すると便利です。

この接続属性で指定された速度は、すべてのバックグラウンド・チェックポイントと、ttCkptおよびttCkptBlockingの組込みプロシージャで開始されたチェックポイントに使用されます。フォアグラウンド・チェックポイント(初期の接続時と最後の接続解除時のチェックポイント)では使用されません。この速度は、MB/秒単位で指定します。

値が0 (ゼロ)の場合、速度は制限されません。これはデフォルトです。この値は、組込みプロシージャttCkptConfigで指定することもできます。その場合は、組込みプロシージャttCkptConfigで設定した値で、この属性で設定されている値が置き換えられます。

この属性の値は「スティッキー」で、値が明示的に変更されないかぎり、データベースのロードからアンロードまで維持されます。デフォルト値はデータベースの作成中にのみ使用されます。後続の初期接続では、データベースに保存された既存の値がデフォルトで使用されます。未指定のままにした(またはWindows ODBCデータソース・アドミニストレータが空の)場合、TimesTenでは保存されている設定が使用されます。この属性を無効にするには、0の値を明示的に指定する必要があります。このリリースに移行された既存のデータベースでは、この値は0に初期化されています。現在の値またはデフォルトの値を使用するには、この属性値を未指定のままにしておく必要があります。

CkptRateを使用する場合の利点および問題の詳細は、『Oracle TimesTen In-Memory Databaseオペレーション・ガイド』のチェックポイント処理速度の設定に関する説明を参照してください。

必要な権限

インスタンス管理者のみがこの属性の値を変更できます。

設定

CkptRateは次のように設定します。

属性の設定場所

属性の表示

設定

CまたはJavaプログラム、あるいはUNIX odbc.iniファイル

CkptRate

チェックポイントをディスクに書き込む速度の最大値をMB/秒単位で指定します。
値0 (ゼロ)は、速度が制限されないことを示します。これはデフォルトです。

この属性を指定しない場合、TimesTenはデータベースの作成にデフォルト値(0)を使用します。TimesTenでは、既存のデータベースには保存された値が使用されます。

属性を指定しても値を指定しない場合には、値0が使用されます。

-1の値を指定すると、この属性を省略したことになります。-1の値を指定した場合、データベースの作成にデフォルト値(0)が使用され、それ以外の場合は保存された値が使用されます。

Windows ODBCデータソース・アドミニストレータ

「CkptRate」フィールド

チェックポイントをディスクに書き込む速度の最大値をMB/秒単位で指定します。
値0 (ゼロ)は、速度が制限されないことを示します。これはデフォルトです。

この属性を指定しない場合、TimesTenはデータベースの作成にデフォルト値(0)を使用します。TimesTenでは、既存のデータベースには保存された値が使用されます。

属性を指定しても値を指定しない場合には、TimesTenはデフォルト値(0)を使用します。

CkptReadThreads

最初の接続またはリカバリの操作などで、データベースをメモリーにロードする際にチェックポイント・ファイルの読取りに使用されるスレッドの数を決定します。

CkptReadThreads属性が1に設定されると、TimesTenはチェックポイント・ファイルを順次読み取ります。CkptReadThreads属性が1より大きい値に設定されると、TimesTenは指定されたスレッド数を使用して、チェックポイント・ファイルを同時に読み取ります。CkptReadThreads属性が0に設定されているか指定されていない場合、以前に指定された値が使用されます。

必要な権限

インスタンス管理者のみがこの属性の値を変更できます。

設定

CkptReadThreadsは次のように設定します。

属性の設定場所

属性の表示

設定

CまたはJavaプログラム、あるいはUNIX odbc.iniファイル

CkptReadThreads

n - メモリーへのデータベースのロード中にチェックポイント・ファイルを読み取る際に使用するスレッドの数。0以上の整数値を取ります(最大 = 2^31-1)。デフォルトは1です。

Windows ODBCデータソース・アドミニストレータ

「Checkpoint Read Threads」フィールド

n - メモリーへのデータベースのロード中にチェックポイント・ファイルを読み取る際に使用するスレッドの数。0以上の整数値を取ります(最大 = 2^31-1)。デフォルトは1です。

注意

リカバリ・プロセスの進捗状況のレポートについては、サポート・ログの再作成メッセージを参照してください。

その他のサービスやプロセスのためにTimesTenサーバー上に十分なリソースを残すよう、スレッドの数は低く設定します。

Connections

データベースへのユーザー指定の同時接続数の上限を示します。TimesTenは、予測される接続ごとに1つのセマフォを割り当てます。接続数がこの属性の値を超えた場合、TimesTenはエラーを返します。

データベースへの現在の接続数を確認するには、ttStatusユーティリティの出力を表示します。

Connectionsの値が0または指定されていない場合、セマフォのデフォルトの数を使用する必要があります。許可される最大接続数は2047です。TimesTenは内部使用のために47接続を予約し、最大2000接続をアプリケーションが使用するために残しています。ガイドラインとしては、この値は予測されるアプリケーションの最大接続数に10%を加えた値に設定します。

接続数がこの属性の値を超えたことを示すエラーが表示された場合は、このエラーが表示されなくなるまで値を増やしてください。

PL/SQLを有効にすると(PLSQL=1)、PL/SQLを使用していなくても、PL/SQLセグメントから割り当てられた固定オーバーヘッドおよび接続ごとのオーバーヘッドの両方が存在することになります。詳細は、「PLSQL_MEMORY_SIZE」を参照してください。

注意:
すべてのアクティブなデータベースを処理するには、カーネルに十分なセマフォが設定されている必要があります。システムへのセマフォの設定については、『Oracle TimesTen In-Memory Databaseインストレーション・ガイド』のインストールの前提条件に関する説明を参照してください。

必要な権限

インスタンス管理者のみがこの属性の値を変更できます。

設定

Connectionsは次のように設定します。

属性の設定場所

属性の表示

設定

CまたはJavaプログラム、あるいはUNIX odbc.iniファイル

Connections

0または値なし: デフォルト値が使用されることを示します。
デフォルト値は2000未満またはSEMMSLカーネル・パラメータで指定されたセマフォの数です。

1から2000の整数: 値は予測される最大接続数を表します。

Windows ODBCデータソース・アドミニストレータ

「Connections」フィールド

0または値なし: デフォルト値が使用されることを示します。
デフォルト値は2000です。

1から2000の整数: 値は予測される最大接続数を表します。

ForceConnect

RETURN RECEIPTレプリケーションがNONDURABLE TRANSMITオプションで使用されている場合、障害が発生したマスター・データベースは、ttRepAdminユーティリティの-duplicateオプションを使用したサブスクライバ・データベースから状態をリストアすることによってのみリカバリできます。つまり、サブスクライバに転送されたが、ローカルに永続的にはコミットされない一部のトランザクションが失われる可能性があるため、障害が発生したデータベースは起動できず、レプリケーションによって最新状態に戻すことができません。ForceConnect接続は、この制限を上書きします。

ttConfiguration組込みプロシージャは、ForceConnect属性の値を返しません。

必要な権限

この属性の値の変更に権限は必要ありません。

設定

ForceConnectは次のように設定します。

属性の設定場所

属性の表示

設定

CまたはJavaプログラム、あるいはUNIX odbc.iniファイル

ForceConnect

0(デフォルト): 対応するサブスクライバ・データベースから適切にリストアされなかった場合は、障害が発生したデータベースへの接続を許可しません。
1: 対応するサブスクライバ・データベースから適切にリストアされなかった場合でも、障害が発生したデータベースへの接続を許可します。

Windows ODBCデータソース・アドミニストレータ

「ForceConnect」チェック・ボックス

選択解除(デフォルト): 対応するサブスクライバ・データベースから適切にリストアされなかった場合は、障害が発生したデータベースへの接続を許可しません。
選択: 対応するサブスクライバ・データベースから適切にリストアされなかった場合でも、障害が発生したデータベースへの接続を許可します。

LogAutoTruncate

TimesTenリカバリでログ・レコードに問題が発生した場合、データベースへの初期接続を継続するかどうかを指定します。

必要な権限

インスタンス管理者のみがこの属性の値を変更できます。

設定

LogAutoTruncateは次のように設定します。

属性の設定場所

属性の表示

設定

CまたはJavaプログラム、あるいはUNIX odbc.iniファイル

LogAutoTruncate

0: ログ・レコードに問題が発生した場合、リカバリを終了し、接続しているアプリケーションにエラーを返します。チェックポイントおよびトランザクション・ログ・ファイルは未変更のままになります。
1(デフォルト): ログ・レコードに問題が発生した場合、問題が発生したレコードの位置でそのログを切り捨て、リカバリを続行します。元のトランザクション・ログ・ファイルは、ログ・ディレクトリのサブディレクトリとして作成されるsavedLogFilesという名前のディレクトリに移されます。トランザクション・ログ・ファイルは診断のために保存されます。

Windows ODBCデータソース・アドミニストレータ

「LogAutoTruncate」ボックス

選択解除: ログ・レコードに問題が発生した場合、リカバリを終了し、接続しているアプリケーションにエラーを返します。チェックポイントおよびトランザクション・ログ・ファイルは未変更のままになります。
選択(デフォルト): ログ・レコードに問題が発生した場合、問題が発生したレコードの位置でそのログを切り捨て、リカバリを続行します。元のトランザクション・ログ・ファイルは、ログ・ディレクトリのサブディレクトリとして作成されるsavedLogFilesという名前のディレクトリに移されます。トランザクション・ログ・ファイルは診断のために保存されます。

LogBufMB

LogBufMB属性では、内部トランザクション・ログ・バッファのサイズをMB単位で指定します。デフォルトのログ・バッファ・サイズは64MBです。

LogBufMBの値を変更する場合は、LogBufMB/LogBufParallelism >=8という制約を満たすためにLogBufParallelismの値も変更する必要があります。

LogBufMBの値を増やす場合、LogFileSizeの値がLogBufMBの値以上(LogFileSize >= LogBufMB)であることを確認してください。

必要な権限

インスタンス管理者のみがこの属性の値を変更できます。

設定

LogBufMBは次のように設定します。

属性の設定場所

属性の表示

設定

CまたはJavaプログラム、あるいはUNIX odbc.iniファイル

LogBufMB

n: ログ・バッファのサイズ(MB単位)。
設定されず、データベースが存在している場合には、TimesTenはデータベースに保存された値を使用します。

設定されず、データベースが作成される場合には、TimesTenはデフォルトの値(64)を使用します。

32ビット・システムでは、ログ・ファイルの最大サイズは1024MB(1GB)です。

64ビット・システムでは、最大値は65,536MB(64GB)です。

Windows ODBCデータソース・アドミニストレータ

「Log Buffer Size (MB)」フィールド

ログ・バッファのサイズ(MB単位)。
設定されず、データベースが存在している場合には、TimesTenはデータベースに保存された値を使用します。

設定されず、データベースが作成される場合には、TimesTenはデフォルトの値(64)を使用します。

32ビット・システムでは、ログ・ファイルの最大サイズは1024MB(1GB)です。

64ビット・システムでは、最大値は65,536MB(64GB)です。

LogBufParallelism

LogBufParallelism属性では、ログがディスクに書き込まれる前にTimesTenがログ・ファイルを書き込むトランザクション・ログ・バッファのストランド数を指定することで、ログ・パフォーマンスを向上させることができます。各バッファには専用の挿入ラッチがあります。レコードはいずれかのストランドに挿入されます。ログ・フラッシャによって、すべてのストランドからレコードが収集され、ログ・ファイルに書き込まれます。

ストランドの最大数は64です。デフォルトは4です。

LogBufParallelismの値を変更する場合は、LogBufMB/LogBufParallelism >=8という制約を満たすためにLogBufMBの値も変更する必要があります。

必要な権限

インスタンス管理者のみがこの属性の値を変更できます。

設定

LogBufParallelismは次のように設定します。

属性の設定場所

属性の表示

設定

CまたはJavaプログラム、あるいはUNIX odbc.iniファイル

LogBufParallelism

整数値は1から64までの値です。デフォルトは4です。

Windows ODBCデータソース・アドミニストレータ

「Log Buffer Parallelism」フィールド

整数値は1から64までの値です。デフォルトは4です。

LogFileSize

LogFileSize属性では、トランザクション・ログ・ファイルの最大サイズをMB単位で指定します。最小値は8MBです。デフォルト値は64MBです。8MBより小さいサイズを指定した場合、TimesTenはエラー・メッセージを返します。TimesTen 11.2.1.4より前のリリースでは、最小サイズは1MBでした。TimesTenの以前のリリースでデータベースを作成し、ログ・ファイル・サイズに8MBより小さい値を指定していた場合は、エラーを避けるためにこの属性に割り当てられている値を増やす必要があります。

ログ・レコードは複数のトランザクション・ログ・ファイルにまたがることができないので、実際のトランザクション・ログ・ファイル・サイズはLogFileSizeよりもわずかに小さいか、大きいことがあります。

0を指定した場合、データベースが存在しない場合にはTimesTenではデフォルトのトランザクション・ログ・ファイル・サイズが使用されます。データベースが存在している場合には、TimesTenでは現在の指定されたトランザクション・ログ・ファイル・サイズが使用されます。

LogFileSizeの値をLogBufMBの値以上に設定します(LogFileSize >= LogBufMB)。

必要な権限

インスタンス管理者のみがこの属性の値を変更できます。

設定

LogFileSizeは次のように設定します。

属性の設定場所

属性の表示

設定

CまたはJavaプログラム、あるいはUNIX odbc.iniファイル

LogFileSize

n: トランザクション・ログ・ファイルのサイズ(MB単位)。デフォルトは、データベース作成時は64、後続の接続では0 (現在のサイズが有効)です。最小サイズは8MBです。
32ビット・システムでは、ログ・ファイルの最大サイズは1024MB(1GB)です。

64ビット・システムでは、最大値は65,536MB(64GB)です。

Windows ODBCデータソース・アドミニストレータ

「Log Files Size (MB)」フィールド

トランザクション・ログ・ファイルのサイズ(MB単位)。デフォルトは、データベース作成時は64、後続の接続では0 (現在のサイズが有効)です。最小サイズは8MBです。
32ビット・システムでは、ログ・ファイルの最大サイズは1024MB(1GB)です。

64ビット・システムでは、最大値は65,536MB(64GB)です。

LogFlushMethod

TimesTenによってトランザクション・ログ・ファイルへのログ・データの書込みおよび同期化に使用される方法を制御します。システムの全体的なスループットは、特に、アプリケーションが大部分のトランザクションを永続的にコミットすることを選択した場合、この属性の値によって大きく影響されます。

一般的に、トランザクションの大部分が永続的にコミットする場合は値2を使用し、それ以外の場合は値1を使用します。

ただし、最良の結果を得るには、アプリケーションとプラットフォームの標準的なワークロードを使用して、両方の値を試してみます。アプリケーションのパフォーマンスはこの属性によって影響を受ける場合がありますが、トランザクションの永続性は影響を受けません。この属性の値を変更しても、トランザクションの永続性には影響を与えません。

必要な権限

インスタンス管理者のみがこの属性の値を変更できます。

設定

LogFlushMethodは次のように設定します。

属性の設定場所

属性の表示

設定

CまたはJavaプログラム、あるいはUNIX odbc.iniファイル

LogFlushMethod

0: 前回使用した値を使用してトランザクション・ログ・ファイルにデータを書き込みます。
1(デフォルト): バッファされた書込みを使用してトランザクション・ログ・ファイルにデータを書き込み、必要に応じて明示的な同期化処理を使用してディスクへのログ・データを、永続的コミットなどと同期化します。

2: 明示的な同期化処理が必要にならないように、同期書込みを使用してトランザクション・ログ・ファイルにデータを書き込みます。

Windows ODBCデータソース・アドミニストレータ

「Log Flush Method」ドロップダウン・リスト

0: 前回使用した値を使用してトランザクション・ログ・ファイルにデータを書き込みます。
1(デフォルト): バッファされた書込みを使用してトランザクション・ログ・ファイルにデータを書き込み、必要に応じて明示的な同期化処理を使用してディスクへのログ・データを、永続的コミットなどと同期化します。

2: 明示的な同期化処理が必要にならないように、同期書込みを使用してトランザクション・ログ・ファイルにデータを書き込みます。

関連項目

DurableCommits

LogPurge

LogPurge属性を設定すると、TimesTenでは、トランザクション・ログ・ファイルが2つのチェックポイント・ファイルに書き込まれ、その内容を必要とするトランザクションがなくなった場合、そのトランザクション・ログ・ファイルが自動的に削除されます。チェックポイントが最初にコールされると、TimesTenによりトランザクション・ログ・ファイルの内容はチェックポイント・ファイルの1つに書き込まれます。チェックポイントが2度目にコールされると、TimesTenはトランザクション・ログ・ファイルの内容をもう1つのチェックポイント・ファイルに書き込みます。

次の条件がすべて満たされた場合、TimesTenはトランザクション・ログ・ファイルを消去します。

- トランザクション・ログ・ファイルの内容が2つのチェックポイント・ファイルに書き込まれている。

- 増分バックアップによってトランザクション・ログ・ファイルが保留されていない。

- レプリケーションを使用している場合、トランザクション・ログ・ファイルがすべてのサブスクライバにレプリケートされている。

- XLAを使用している場合、XLAのすべてのブックマークがトランザクション・ログ・ファイルより新しい。

- XAインタフェースを使用する分散トランザクションでトランザクション・ログ・ファイルが使用されていない。

この属性を0に設定するか選択解除する場合、不要なトランザクション・ログ・ファイルには.arch接尾辞が追加されます。アプリケーションはこれらのファイルを削除できます。

必要な権限

インスタンス管理者のみがこの属性の値を変更できます。

設定

LogPurgeは次のように設定します。

属性の設定場所

属性の表示

設定

CまたはJavaプログラム、あるいはUNIX odbc.iniファイル

LogPurge

0: 接続時およびチェックポイント時に古いトランザクション・ログ・ファイルを削除しません。
1(デフォルト): 接続時およびチェックポイント時に古いトランザクション・ログ・ファイルを削除します。

Windows ODBCデータソース・アドミニストレータ

「LogPurge」チェック・ボックス

選択解除: 接続時およびチェックポイント時に古いトランザクション・ログ・ファイルを削除しません。
選択(デフォルト): 接続時およびチェックポイント時に古いトランザクション・ログ・ファイルを削除します。

関連項目

MatchLogOpts

MemoryLock

Solaris、LinuxおよびWindows 64ビット・システムの場合、TimesTenでは、共有データベースに接続するアプリケーションは、データベースがメモリーにロード中か、またはメモリー内にデータ・ストアが存在するいずれかの場合に、実メモリーをロックするかどうかを指定できます。データベースに使用される物理メモリーがロックされた場合、オペレーティング・システムの仮想メモリー・サブシステムでは、その他の用途にその物理メモリーを使用することができません。データベースのいずれの部分もページアウトすることはありませんが、RAMで構成されたシステムでは、メモリー不足が発生することがあります。メモリーをロックするとデータベースのロード・パフォーマンスが向上する可能性がありますが、同じコンピュータ上の他のアプリケーションに影響を及ぼす可能性があります。

AIXでは、MemoryLock属性は実装されていません。AIXでラージ・ページを使用すると、共有メモリー・セグメントはロックされます。ラージ・ページを使用することで、共有セグメントをロックできます。『Oracle TimesTen In-Memory Databaseインストレーション・ガイド』で、ラージ・ページの詳細を説明しています。

PL/SQLの共有メモリー・セグメントは、MemoryLockの対象ではありません。

必要な権限

インスタンス管理者のみがこの属性の値を変更できます。

Linuxシステムの場合、MemLock設定のgroupnameは、/etc/security/limits.confファイル内のインスタンス管理者と同じ値に設定します。MemLockの値は、TimesTenデータベースの共有メモリー・セグメント以上の大きさに設定します。

Solarisシステムでは、インスタンス管理者はMemoryLockを1または2に設定するために、proc_lock_memory権限を持っている必要があります。MemoryLockを3または4に設定するためには、特別な権限は必要ありません。MemoryLockを3または4に設定すると、SolarisのIntimate Shared Memory (ISM)を使用できるようになります。

権限を表示するには、次のコマンドを実行します。

% ppriv $$

ユーザーID timestenに権限を追加するには、ルートユーザーは次のコマンドを実行します。

# usermod -K defaultpriv=basic,proc_lock_memory timesten

権限の追加後、timestenユーザーは新しいシェルにログインし、メモリーからすべてのTimesTenデータベースをアンロードし、TimesTenデーモンを再起動する必要があります。

TimesTenデーモンを再起動するには、新しいログイン・シェルで次のコマンドを実行します。

% ttDaemonadmin -restart

設定

MemoryLockは次のように設定します。

属性の設定場所

属性の表示

設定

CまたはJavaプログラム、あるいはUNIX odbc.iniファイル

MemoryLock

0(デフォルト): メモリーをロックしません。
1: メモリー・ロックを取得しようとします。ロックできなくても、接続は成功します。ロックを取得した場合、データベースのメモリーへのロード後にロックが解除されます(推奨)。

2: メモリー・ロックが必要です。ロックできない場合、接続は失敗します。ロックを取得した場合、接続は成功し、データベースのメモリーへのロード後にロックが解除されます。

3: メモリー・ロックを取得して保持しようとします。ロックできなくても、接続は成功します。メモリー・ロックを取得した場合、接続は成功し、メモリー・ロックはデータベースがメモリーからアンロードされるまで保持されます。

4: メモリー・ロックは必要であり、データベースがメモリーからアンロードされるまで保持されます。ロックできない場合、接続は失敗します。ロックを取得した場合、接続は成功し、メモリー・ロックはデータベースがメモリーからアンロードされるまで保持されます。

Windows ODBCデータソース・アドミニストレータ

「Memory Lock」フィールド

0(デフォルト): メモリーをロックしません。
1: メモリー・ロックを取得しようとします。ロックできなくても、接続は成功します。ロックを取得した場合、データベースのメモリーへのロード後にロックが解除されます(推奨)。

2: メモリー・ロックが必要です。ロックできない場合、接続は失敗します。ロックを取得した場合、接続は成功し、データベースのメモリーへのロード後にロックが解除されます。

3: メモリー・ロックを取得して保持しようとします。ロックできなくても、接続は成功します。メモリー・ロックを取得した場合、接続は成功し、メモリー・ロックはデータベースがメモリーからアンロードされるまで保持されます。

4: メモリー・ロックは必要であり、データベースがメモリーからアンロードされるまで保持されます。ロックできない場合、接続は失敗します。ロックを取得した場合、接続は成功し、メモリー・ロックはデータベースがメモリーからアンロードされるまで保持されます。

Overwrite

Overwrite属性が設定され、新しいデータベースと同じデータベース・パス名を持つ既存のデータベースが存在する場合、TimesTenは、使用中でなければ既存のデータベースを破棄し、新しい空のデータベースを作成します。Overwrite属性が設定され、指定したデータベース・パス名を持つデータベースが存在しない場合、TimesTenは、AutoCreate属性が設定されている場合にのみ新しいデータベースを作成します(「AutoCreate」を参照)。AutoCreateが0に設定されている場合には、TimesTenではOverwrite属性が無視されます。Overwrite =1の属性を指定する場合、アプリケーションでは注意が必要です。

必要な権限

インスタンス管理者のみがこの属性の値を変更できます。インスタンス管理者以外のユーザーがOverwrite=1でデータベースに接続しようとすると、TimesTenによってエラーが返されます。

設定

Overwriteは次のように設定します。

属性の設定場所

属性の表示

設定

CまたはJavaプログラム、あるいはUNIX odbc.iniファイル

Overwrite

0 (デフォルト): TimesTenは同じパス名を持つ既存のデータベースを上書きしません。
1: TimesTenは同じパス名を持つ既存のデータベースを上書きします。

Windows ODBCデータソース・アドミニストレータ

利用できません。

利用できません。

PermSize

データベースの永続メモリーの領域サイズをMB単位で指定します。最初の接続では、PermSizeを増やすことはできますが、減らすことはできません。永続メモリーの領域サイズを減らそうとすると、TimesTenによって警告が戻されます。データベースが存在しない場合に、PermSizeの値が0または値が指定されてない場合はデフォルト・サイズが使用されることを示します。デフォルト・サイズは32MBです。データベースが存在する場合に、値が0または値が指定されていない場合は既存のサイズが変更されないことを示します。

一度データベースを作成すると、永続パーティションを大きくすることはできますが、小さくすることはできません。『Oracle TimesTen In-Memory Databaseオペレーション・ガイド』のデータベースのサイズの指定に関する説明を参照してください。

「TempSize」接続属性に関する情報も参照してください。

適切な場合、ttMigrateおよびttDestroyユーティリティを使用して、「Permanent Data Size」を変更することもできます。

必要な権限

インスタンス管理者のみがこの属性の値を変更できます。

設定

PermSizeは次のように設定します。

属性の設定場所

属性の表示

設定

CまたはJavaプログラム、あるいはUNIX odbc.iniファイル

PermSize

n: データベースの永続パーティションのサイズで(MB単位)、デフォルトは、32ビット・システムと64ビット・システムの両方で32MBです。最小サイズは32MBです。

Windows ODBCデータソース・アドミニストレータ

「Permanent Data Size」フィールド

n: データベースの永続パーティションのサイズで(MB単位)、デフォルトは、32ビット・システムと64ビット・システムの両方で32MBです。最小サイズは32MBです。

ReceiverThreads

この属性は、アクティブ・スタンバイ・ペアのレプリケーション・スキームで、アクティブ・マスター・データベースへの変更をスタンバイ・マスター・データベースに適用するために使用するスレッドの数を制御します。デフォルトは1です。また、この属性をアクティブ・スタンバイ・ペアのレプリケーション・スキームの1つ以上の読取り専用サブスクライバに対して設定し、スタンバイ・マスター・データベースからサブスクライバへのレプリケーションのスループットを向上させることもできます。

デフォルトでは、レプリケーション・エージェントのRECEIVERスレッドによって変更がスタンバイ・マスター・データベースに適用されます。この属性を2に設定すると、もう1つのスレッドによって変更が適用されます。この属性を2に設定する利点を活用するには、2コア(または2ハードウェア・スレッド)以上のシステムでデータベースをホストする必要があります。

スタンバイ・マスター・データベースでこの属性を2に設定した場合、フェイルオーバー発生時の高いスループットを維持するために、アクティブ・マスター・データベースでもこの属性を2に設定する必要があります。

必要な権限

インスタンス管理者のみがこの属性の値を変更できます。

設定

ReceiverThreadsは次のように設定します。

属性の設定場所

属性の表示

設定

CまたはJavaプログラム、あるいはUNIX odbc.iniファイル

ReceiverThreads

n: アクティブ・マスター・データベースからスタンバイ・マスター・データベースに変更を適用するために使用するスレッドの数です。また、この属性をアクティブ・スタンバイ・ペアのレプリケーション・スキームの1つ以上の読取り専用サブスクライバに対して設定し、スタンバイ・マスター・データベースからサブスクライバへのレプリケーションのスループットを向上させることもできます。
使用可能な値は、1および2です。デフォルトは1です。

Windows ODBCデータソース・アドミニストレータ

「ReceiverThreads」フィールド

n: アクティブ・マスター・データベースからスタンバイ・マスター・データベースに変更を適用するために使用するスレッドの数です。また、この属性をアクティブ・スタンバイ・ペアのレプリケーション・スキームの1つ以上の読取り専用サブスクライバに対して設定し、スタンバイ・マスター・データベースからサブスクライバへのレプリケーションのスループットを向上させることもできます。
使用可能な値は、1および2です。デフォルトは1です。

RecoveryThreads

RecoveryThreads属性では、リカバリ中に索引を再作成するために使用するスレッドの数を決定します。

RecoveryThreads=1の場合、リカバリ中に、再作成する必要がある索引は順次再作成されます。索引の再作成を処理するのに十分なプロセッサがコンピュータ上にある場合は、この属性を1よりも大きな数に設定すると、リカバリのパフォーマンスを向上させることができます。異なるプロセッサが異なる索引を処理できる場合にのみ、パフォーマンスが向上します。同じ索引内の索引の再作成に並列処理はありません。

RecoveryThreadsの値は、システム上で使用可能なCPUの数までの値です。

データベースの作成時のデフォルトは1です。後続の接続に対しては、データベースをリカバリする必要があり、RecoveryThreadsが未指定または値が0の場合、TimesTenはこの属性の以前の設定を使用します。

必要な権限

インスタンス管理者のみがこの属性の値を変更できます。

設定

RecoveryThreadsは次のように設定します。

属性の設定場所

属性の表示

設定

CまたはJavaプログラム、あるいはUNIX odbc.iniファイル

RecoveryThreads

n: リカバリ中に索引を再作成するために使用するスレッドの数です。デフォルトは、データベースの作成時には1、後続の接続に対しては0です。

Windows ODBCデータソース・アドミニストレータ

「RecoveryThreads」フィールド

n: リカバリ中に索引を再作成するために使用するスレッドの数です。デフォルトは、データベースの作成時には1、後続の接続に対しては0です。

注意

リカバリ・プロセスの進捗状況のレポートについては、サポート・ログの再作成メッセージを参照してください。

その他のサービスやプロセスのためにTimesTenサーバー上に十分なリソースを残すよう、スレッドの数は低く設定します。

TempSize

TempSizeには、一時領域に割り当てられるメモリーの総量をMB単位で指定します。

TempSizeに事前定義されている値はありません。指定しない場合、その値は次の式に従ってPermSizeから決定されます。

- PermSizeが64MBより小さい場合: TempSize = 32MB + 上限(PermSize/4MB)。

- それ以外の場合: Tempsize = 40MB + 上限(PermSize/8MB)。

TimesTenでは、値は最も近いMBに切り上げられます。

指定した場合、TimesTenでは常にTempSizeの値が使用されます。データベースがロードされるたびに一時データ・パーティションが再作成されるため、ロードのたびにTempSize属性を増減することができます。データベースが存在する場合に、値が0または値が指定されていない場合は既存のサイズが変更されないことを示します。TempSizeの最小値は32MBです。

必要な権限

インスタンス管理者のみがこの属性の値を変更できます。

設定

TempSizeは次のように設定します。

属性の設定場所

属性の表示

設定

CまたはJavaプログラム、あるいはUNIX odbc.iniファイル

TempSize

n: データベースの一時パーティションのサイズ(MB単位)。最小サイズは、すべてのプラットフォームで32MBです。

Windows ODBCデータソース・アドミニストレータ

「Temporary Data Size」フィールド

n: データベースの一時パーティションのサイズ(MB単位)。最小サイズは、すべてのプラットフォームで32MBです。

一般接続属性

一般接続属性は各接続によって設定され、接続が継続している間持続します。この項では、表1-3「一般接続属性」に示した一般接続属性について説明します。

CommitBufferSizeMax

CommitBufferSizeMaxには、トランザクション・コミット・バッファに割り当てられるメモリーの総量をMB単位で指定します。再利用レコードのサイズを処理するにはこの属性を設定します。

ALTER SESSION SQL文(『Oracle TimesTen In-Memory Database SQLリファレンス』を参照)を使用して、セッション内でのコミット・バッファの最大サイズを割当てまたは変更できます。新しい値は、新しいトランザクションが開始したときに有効になります。

ALTER SESSION SET COMMIT_BUFFER_SIZE_MAX = n;

設定されたコミット・バッファの最大サイズは、ttConfiguration組込みプロシージャをコールすることによって確認できます。

コミット・バッファ・サイズの設定方法を含む再利用操作の詳細は、『Oracle TimesTen In-Memory Databaseオペレーション・ガイド』のトランザクション再利用操作に関する説明を参照してください。また、組込みプロシージャttCommitBufferStatsおよびttCommitBufferStatsResetについての情報も参照してください。

必要な権限

この属性の値の変更に権限は必要ありません。

設定

CommitBufferSizeは次のように設定します。

属性の設定場所

属性の表示

設定

CまたはJavaプログラム、あるいはUNIX odbc.iniファイル

CommitBufferSizse

0: コミット・バッファはデフォルトのサイズ(128K)で構成されます。
n - 整数値。最小ユーザー設定サイズは1 (MB)です。この値はTempSizeより小さく設定する必要があります。

Windows ODBCデータソース・アドミニストレータ

「Maximum Commit Buffer Size」フィールド

n - 整数値。最小ユーザー設定サイズは1 (MB)です。この値はTempSizeより小さく設定する必要があります。

注意

組込みプロシージャttCommitBufferStatsをコールすると、コミット・バッファ統計はバイトで表されます。ただし、ttConfiguration組込みプロシージャの出力および接続属性CommitBufferSizeMaxによって設定された値はMB単位で表されます。

ConnectionName

この属性は、クライアントの接続属性としても使用できます。

この属性を使用すると、任意のデータベース接続にシンボリック名を付けることができます。接続名は1つのプロセス内で一意です。

TimesTenでは、シンボリック名はttIsql、ttXactAdmin、ttStatusなどの様々な管理ユーティリティの接続を特定する場合に使用されます。これは、マルチスレッド・アプリケーション、リモート・クライアントの識別などのように、データベースに対して複数の接続を行うプロセスで特に有効です。

この属性の値は、接続文字列を使用して接続時に動的に定義します。デフォルト値は、接続の実行可能ファイル名です。また、DSN定義で静的に定義することもできます。ConnectionNameに使用する値は、SQL識別子構文ルールに従っている必要があります。

必要な権限

この属性の値の変更に権限は必要ありません。

設定

ConnectionNameは次のように設定します。

属性の設定場所

属性の表示

設定

CまたはJavaプログラム、あるいはUNIX odbc.iniファイル

ConnectionName

接続の名前を表す最大30文字の文字列を入力します。指定した接続名またはデフォルトの接続名がすでに使用されている場合、TimesTenは名前にconnを割り当てます(ここでnは、名前を一意にするための0より大きい整数値です)。指定しない場合は、接続中のプロセスの名前が使用されます。

Windows ODBCデータソース・アドミニストレータ

「Connection」フィールド

接続の名前を表す最大30文字の文字列を入力します。指定した接続名またはデフォルトの接続名がすでに使用されている場合、TimesTenは名前にconnを割り当てます(ここでnは、名前を一意にするための0より大きい整数値です)。指定しない場合は、接続中のプロセスの名前が使用されます。

DDLCommitBehavior

この属性は、データ定義言語(DDL)文に関連してトランザクションのコミット動作を制御します。

トランザクションの動作は、従来のTimesTenの動作またはOracle Databaseの動作に設定できます。

- 従来、TimesTenのデータベースでは、DDL文は現在のトランザクションの一部として実行され、トランザクションの残りの部分と一緒にコミットまたはロールバックされます。

- Oracle Databaseでは、DDL文の前後に暗黙的なコミットが発行されます。

注意:
PLSQLサポートが有効になっている場合は、DDLCommitBehaviorをOracleトランザクションのコミット動作(値0)に設定する必要があります。
XAトランザクションでDDL文を使用しないでください。

DDL文には次のものがあります。

- すべてのデータベース・オブジェクト(表、ビュー、ユーザー・プロシージャ、索引など)のCREATE、ALTERまたはDROP

- TRUNCATE

- GRANTおよびREVOKE

必要な権限

この属性の値の変更に権限は必要ありません。

設定

DDLCommitBehaviorは次のように設定します。

属性の設定場所

属性の表示

設定

CまたはJavaプログラム、あるいはUNIX odbc.iniファイル

DDLCommitBehavior

0(デフォルト): Oracle Databaseスタイルの動作です。DDL文が実行される前にトランザクションの暗黙的なコミットが実行され、DDL文が実行された後に永続的コミットが実行されます。
1: 従来のTimesTenスタイルの動作です。DDL文の実行によって、トランザクションの暗黙的コミットがトリガーされません。

Windows ODBCデータソース・アドミニストレータ

「DDLCommitBehavior」フィールド

0(デフォルト): Oracle Databaseスタイルの動作です。DDL文が実行される前にトランザクションの暗黙的なコミットが実行され、DDL文が実行された後に永続的コミットが実行されます。
1: 従来のTimesTenスタイルの動作です。DDL文の実行によって、トランザクションの暗黙的コミットがトリガーされません。

例

例1-1 TimesTenのコミット動作

AUTOCOMMIT OFF;
CREATE TABLE t1 (c1 Varchar2(10));
COMMIT;

INSERT INTO t1 VALUES('some data');
1 row inserted.

CREATE TABLE t2 (c1 INTEGER);

ROLLBACK;

SELECT * FROM t1;
0 rows found.

SELECT * FROM t2;
2206: Table ttuser.t2 not found
The command failed.

INSERT INTO t1 VALUES('more data');
1 row inserted.

CREATE TABLE t1 (c1 VARCHAR2(10));
2207: Table t1 already exists
The command failed.

ROLLBACK;

SELECT * FROM t1;
0 rows found.

例1-2 Oracleのコミット動作

次の例は、Oracleの動作(DDLCommitBehavior=0)を示しています。この例では、INSERT文および表t2の作成がコミットされます。2番目の挿入('more data')は、コミットをトリガーするDDL文(表t1の重複作成)が失敗してもコミットされます。

-- implicit commit here

Command> CREATE TABLE t1 (c1 varchar2(10));
Table created.

-- implicit commit here

Command> COMMIT;
Commit complete.

Command> INSERT INTO t1 VALUES('some data');
1 row created.

-- implicit commit here
Command> CREATE TABLE t2 (c1 INTEGER);
Table created.

-- implicit commit here

SQL> ROLLBACK;
Rollback complete.

Command> SELECT * FROM t1;
C1
----------
some data

Command> SELECT * FROM t2;
no rows selected

Command> INSERT INTO t1 VALUES('more data');
1 row created.
-- implicit commit here

Command> CREATE TABLE t1 (c1 VARCHAR2(10));
CREATE TABLE t1 (c1 VARCHAR2(10))
*
ERROR at line 1:
ORA-00955: name is already used by an existing object

-- implicit rollback

Command> ROLLBACK;
Rollback complete.

Command> SELECT * FROM t1;
C1
----------
some data
more data

DDLReplicationAction

表または順序を、作成時にアクティブ・スタンバイ・ペアのレプリケーション・スキームに含めるかどうかを決定します。DDLReplicationLevel接続属性が2または3に設定されている場合、表を含めることができます。DDLReplicationLevel接続属性が3に設定されている場合、順序を含めることができます。

DDL操作のレプリケーションは、DDLReplicationLevel接続属性のセット値により(制限付きで)有効になります。詳細は、「DDLReplicationLevel」を参照してください。

この値は、ALTER SESSION SQL文(『Oracle TimesTen In-Memory Database SQLリファレンス』を参照)によって変更される可能性があります。次に例を示します。

ALTER SESSION SET DDL_REPLICATION_ACTION='EXCLUDE';

ALTER SESSIONで設定される値は、この属性で設定される値を上書きします。

アクティブ・スタンバイ・ペアを変更する例については、『Oracle TimesTen In-Memory Database開発者および管理者ガイド』のアクティブ・スタンバイ・ペアの変更に関する説明を参照してください。

DDLCommitBehavior=0(デフォルト)の場合、DDL操作は自動的にコミットされます。RETURN TWOSAFEが指定されている場合は、エラーおよびタイムアウトが発生する可能性があります(『Oracle TimesTen In-Memory Database開発者および管理者ガイド』のRETURN TWOSAFEに関する説明を参照)。RETURN TWOSAFEタイムアウトが発生すると、LOCAL COMMIT ACTIONが指定されていても、DDLトランザクションはローカルでコミットされます。

DDLのレプリケーションの詳細は、『Oracle TimesTen In-Memory Database開発者および管理者ガイド』のレプリケーションで使用されるユーザー名またはパスワードの変更に関する説明を参照してください。

必要な権限

この属性の値がINCLUDEの場合はADMIN権限が必要です。

設定

DDLReplicationActionは次のように設定します。

属性の設定場所

属性の表示

設定

CまたはJavaプログラム、あるいはUNIX odbc.iniファイル

DDLReplicationAction

INCLUDE (デフォルト): 適切なDDLReplicationLevel値が構成されている場合、表または順序が作成されるとアクティブ・スタンバイ・ペアのスキームに自動的に追加されます。
EXCLUDE: 表または順序が作成されても、アクティブ・スタンバイ・ペアには自動的に追加されません。

Windows ODBCデータソース・アドミニストレータ

DDLReplicationActionフィールド

INCLUDE (デフォルト): 適切なDDLReplicationLevel値が構成されている場合、表または順序が作成されるとアクティブ・スタンバイ・ペアのスキームに自動的に追加されます。
EXCLUDE: 表または順序が作成されても、アクティブ・スタンバイ・ペアには自動的に追加されません。

DDLReplicationLevel

アクティブ・スタンバイ・レプリケーション・スキーム内で、データ定義言語(DDL)文のサブセットのレプリケーションを有効にします。

DDLReplicationLevel接続属性の値が1に設定されている場合、表、索引またはシノニムのCREATE文またはDROP文はスタンバイ・データベースにレプリケートされません。ただし、レプリケート表に対してALTER TABLE ADDまたはDROP COLUMNを使用して列の追加または削除を行うことで、それらのアクションがスタンバイ・データベースにレプリケートされます。

DDLReplicationLevel接続属性の値が2に設定されている場合(デフォルト)、次のDDL文(『Oracle TimesTen In-Memory Database SQLリファレンス』を参照)はスタンバイやサブスクライバにレプリケートされます。

- CREATEまたはDROP INDEX

- CREATEまたはDROP SYNONYM

- CREATEまたはDROP TABLE (CREATE TABLE AS SELECT以外のグローバル一時表を含む)

DDLReplicationLevel接続属性の値が3に設定されている場合、次のDDL文(『Oracle TimesTen In-Memory Database SQLリファレンス』を参照)および値が2に設定されている場合にレプリケートされたDDL文はスタンバイやサブスクライバにレプリケートされます。

- CREATEまたはDROP VIEW

- CREATEまたはDROP SEQUENCE

- UidPwdSet組込みプロシージャを使用してキャッシュ管理ユーザーの名前およびパスワードを設定する場合の、スタンバイ・マスターへの結果のレプリケーション。UidPwdSet組込みプロシージャを実行するためにキャッシュ・エージェントまたはレプリケーション・エージェントを停止して再起動する必要はありません。詳細は、『Oracle TimesTen Application-Tier Database Cacheユーザーズ・ガイド』のキャッシュ・ユーザーの名前またはパスワードの変更に関する説明、またはttCacheUidPwdSetに関する説明を参照してください。

この属性の値は、ALTER SESSION文(『Oracle TimesTen In-Memory Database SQLリファレンス』を参照)によって変更される可能性があります。次に例を示します。

ALTER SESSION SET DDL_REPLICATION_LEVEL=3;

ALTER SESSIONで設定される値は、この属性で設定される値を上書きします。

アクティブ・スタンバイ・ペアを変更する例については、『Oracle TimesTen In-Memory Database開発者および管理者ガイド』のアクティブ・スタンバイ・ペアの変更に関する説明を参照してください。

DDLのレプリケーションの詳細は、『Oracle TimesTen In-Memory Database開発者および管理者ガイド』のレプリケーションで使用されるユーザー名またはパスワードの変更に関する説明を参照してください。

必要な権限

この属性の値の変更に権限は必要ありません。

設定

DDLReplicationLevelは次のように設定します。

属性の設定場所

属性の表示

設定

CまたはJavaプログラム、あるいはUNIX odbc.iniファイル

DDLReplicationLevel

1: ALTER TABLE ADD COLUMNおよびALTER TABLE DROP COLUMNをスタンバイ・データベースにレプリケートします。表、索引またはシノニムのCREATE操作およびDROP操作はスタンバイ・データベースにレプリケートされません。
2(デフォルト): 表、索引、シノニムの作成および削除をレプリケートします。

3: ビューおよび順序の作成および削除をレプリケートし、UidPwdSet組込みプロシージャの結果をレプリケートします。

Windows ODBCデータソース・アドミニストレータ

「DDL Replication Level」フィールド

1: ALTER TABLE ADD COLUMNおよびALTER TABLE DROP COLUMNをスタンバイ・データベースにレプリケートします。表、索引、シノニムのCREATE操作とDROP操作はスタンバイ・データベースにレプリケートされません。
2(デフォルト): 表、索引、シノニムの作成および削除をレプリケートします。

3: ビューおよび順序の作成および削除をレプリケートし、UidPwdSet組込みプロシージャの結果をレプリケートします。

Restrictions

DDL処理のレプリケーションには次の制限があります。

- CREATE TABLE AS SELECT文はレプリケートされません。

- CREATE INDEX文は、空の表に索引を作成するときにのみレプリケートされます。

- 表または順序を、作成時にアクティブ・スタンバイ・ペアのレプリケーション・スキームに含めるかどうかを制御するには、DDLReplicationAction接続属性を使用します。

- CYCLE属性が指定された順序はレプリケートできません。

- オブジェクトは、受信側データベースがそのレベルのレプリケーションをサポートするTimesTenリリースであり、アクティブ・スタンバイ・ペアのレプリケーション・スキーム用に構成されている場合にのみレプリケートされます。たとえば、11.2.2.7.0より前のデータベース・リリースへの順序のレプリケーション(DDL_REPLICATION_LEVEL=3が必要)は、サポートされません。DDLReplicationLevel値が3に設定されている場合、アクティブとスタンバイの両方のマスター・データベースがTimesTenリリース11.2.2.7以上である必要があります。DDL_REPLICATION_LEVEL=2の場合、受信側データベースは、サポートするオブジェクトのレプリケーション用にリリース11.2.1.8.0以上である必要があります。

- UidPwdSet組込みプロシージャに対するすべての制約が適用されます。

- DDLReplicationLevel=1または2の場合、ALTER TABLE ... ADD COLUMN NOT NULL DEFAULT文を使用してNOT NULL列を、レプリケーション・スキームの一部である表に追加するように表を変更することはできません。表にNOT NULL列を追加する前に、まず、レプリケーション・スキームから表を削除する必要があります。ただし、DDLReplicationLevel=3の場合は、NOT NULL列を、レプリケーション・スキームの一部である表に追加するように表を変更できます。

Diagnostics

接続のためにTimesTenによって生成される診断情報のレベルを、アプリケーションで設定できるようにします。TimesTenの診断メッセージは、番号が20000から29999の範囲の警告です。Diagnostics接続属性の値は整数です。

必要な権限

この属性の値の変更に権限は必要ありません。

設定

Diagnosticsは次のように設定します。

属性の設定場所

属性の表示

設定

CまたはJavaプログラム、あるいはUNIX odbc.iniファイル

Diagnostics

0: TimesTenは診断メッセージを生成しません。
1 (デフォルト): TimesTenは基本レベルの診断メッセージを生成します。

Windows ODBCデータソース・アドミニストレータ

「Diagnostics」フィールド

0: TimesTenは診断メッセージを生成しません。
1 (デフォルト): TimesTenは基本レベルの診断メッセージを生成します。

DuplicateBindMode

この属性は、1つのSQL文に同じパラメータが複数回出現する場合に、アプリケーションが従来のTimesTenのパラメータ・バインディングまたはOracleスタイルのパラメータ・バインディングのいずれを使用するかを指定します。

通常、TimesTenでは、SQL文において同じパラメータ名のインスタンスが複数存在する場合、同じパラメータが複数出現しているとみなされます。パラメータにパラメータ番号を割り当てる場合、TimesTenでは、各パラメータ名の最初の出現に対してのみパラメータ番号が割り当てられます。特定の名前が2回目以降に出現しても、独自のパラメータ番号は割り当てられません。この場合、TimesTenアプリケーションは、SQL文における一意のパラメータすべてに対して値をバインドします。同じパラメータ名の異なる出現に対して別の値をバインドしたり、パラメータやパラメータの出現をバインドしないでおくことはできません。Oracle Databaseでは、1つのSQL文に同じパラメータ名の複数のインスタンスがある場合、それらは別々のパラメータとみなされます。パラメータ番号を割り当てる場合、Oracle Databaseでは名前の重複にかかわらず、パラメータが出現するたびに番号が割り当てられます。Oracle Databaseアプリケーションは、少なくとも、各パラメータ名の最初の出現に対して値をバインドします。特定のパラメータがこれ以降に出現した場合は、アプリケーションはパラメータの出現をバインドしないでおくことも、この出現に対して異なる値をバインドすることもできます。

パラメータ・バインディングの詳細は、『Oracle TimesTen In-Memory Database SQLリファレンス・ガイド』を参照してください。

必要な権限

この属性の値の変更に権限は必要ありません。

設定

DuplicateBindModeは次のように設定します。

属性の設定場所

属性の表示

設定

CまたはJavaプログラム、あるいはUNIX odbc.iniファイル

DuplicateBindMode

0 (デフォルト): SQL文はOracleのパラメータ・バインディング・モデルを使用します。
1: SQL文は従来のTimesTenのパラメータ・バインディング・モデルを使用します。

Windows ODBCデータソース・アドミニストレータ

「Duplicate Bind Mode」チェック・ボックス

選択解除(デフォルト): SQL文はOracleのパラメータ・バインディング・モデルを使用します。
選択: SQL文は従来のTimesTenのパラメータ・バインディング・モデルを使用します。

注意

Oracle Call Interfaceを使用している場合は、DuplicateBindModeを0 (ゼロ)に設定する必要があります。

PLSQLが1に設定されていて、DuplicateBindModeが1に設定されている場合は、PL/SQLプログラムは、重複するパラメータ名が含まれるSQL文を発行しない可能性があります。

DurableCommits

デフォルトでは、DurableCommitsは0 (ゼロ)に設定されています。この設定では、ログ・レコードはトランザクションのコミット時にファイル・システムに書き込まれますが、すぐにディスクに書き込まれることはありません。これにより、障害の発生時に一部のコミット済トランザクションが失われる危険はありますが、トランザクションの実行時間が短縮されます。DurableCommitsを1に設定すると、TimesTenによりログ・レコードはトランザクションのコミット時にディスクに書き込まれます。

また、接続でttDurableCommit組込みプロシージャをコールして、選択したトランザクションに対して明示的に永続的コミットを行うこともできます。ttDurableCommitをコールすると、ディスクにログ・バッファがフラッシュされます。ログ・バッファは、すべての接続間で共有されており、すべての接続で実行されたトランザクションのログ・レコードを含みます。

ログ・レコードは、継続的にファイル・システムからディスクにコピーされます。LogFlushMethodを使用して、ファイル・システムがディスクと同期化されるタイミングを制御できます。

必要な権限

この属性の値の変更に権限は必要ありません。

設定

DurableCommitsは次のように設定します。

属性の設定場所

属性の表示

設定

CまたはJavaプログラム、あるいはUNIX odbc.iniファイル

DurableCommits

0 (デフォルト): TimesTenは、トランザクションのコミット時にトランザクション・ログをディスクに書き込みません。
1: TimesTenは、トランザクションのコミット時にログをディスクに書き込みます。

Windows ODBCデータソース・アドミニストレータ

「Durable Commits」チェック・ボックス

選択解除 (デフォルト): TimesTenは、トランザクションのコミット時にトランザクション・ログをディスクに書き込みません。
選択: TimesTenは、トランザクションのコミット時にログをディスクに書き込みます。

関連項目

LogFlushMethod

Isolation

デフォルトでは、TimesTenでは、コミット読取り分離が使用されます。Isolation属性では、接続トランザクションの初期分離レベルを指定します。分離レベルの詳細は、『Oracle TimesTen In-Memory Databaseオペレーション・ガイド』の分離およびロックによる並行性制御に関する説明を参照してください。

この値は、ALTER SESSION文(『Oracle TimesTen In-Memory Database SQLリファレンス』を参照)によって変更される可能性があります。次に例を示します。

ALTER SESSION SET ISOLATION_LEVEL=serializable;

CREATE CACHE GROUP、ALTER CACHE GROUPおよびDROP CACHE GROUP文は、シリアライズ可能分離モードでサポートされません。

パススルーまたはTimesTen Cacheの伝播機能が使用されている場合、TimesTenの分離レベルの設定はOracleセッションに継承されます。TimesTenのシリアライズ可能なモードは、Oracleのシリアライズ可能なモードにマップされます。TimesTenのコミット読取りモードは、Oracleのコミット読取りモードにマップされます。PassThrough属性の詳細は、「PassThrough」を参照してください。

PassThroughを3に設定した場合は、ALTER SESSION文を使用してOracle Database接続時の分離レベルを永続的に変更する必要があります。たとえば、DSN repdb1_1122に接続するには、次のように実行します。

1. ttIsqlをコールし、DSNにPassThroughレベル3で接続します。

% ttIsql;
Command> connect "dsn=repdb1_1122;passthrough=3";
Connection successful:. . .PassThrough=3; TypeMode=0;
<default setting Autocommit=1>

2. AutoCommitを無効にします。

Command> autocommit=0;

3. PassThroughを一時的に0に変更します。

Command> passthrough=0;

4. 分離レベルをシリアライズ可能に変更します。

Command> prepare 1 ALTER SESSION SET ISOLATION_LEVEL=serializable;
Command> commit;
Command> exec=1;

必要な権限

この属性の値の変更に権限は必要ありません。

設定

Isolationは次のように設定します。

属性の設定場所

属性の表示

設定

CまたはJavaプログラム、あるいはUNIX odbc.iniファイル

Isolation

0: シリアライズ可能な分離モードでデータベースに接続します。
1(デフォルト): コミット読取りモードでデータベースに接続します。

Windows ODBCデータソース・アドミニストレータ

「Isolation」ドロップダウン・リスト

0: シリアライズ可能な分離モードでデータベースに接続します。
1(デフォルト): コミット読取り分離モードでデータベースに接続します。

LockLevel

デフォルトでは、TimesTenは同時実行性を最大にする行レベル・ロックを有効にします。行レベル・ロックの場合、トランザクションでは、通常、アクセスする個々の行に対するロックが取得されますが、表全体に対するロックを取得した場合にパフォーマンスが向上するとTimesTenが判断した場合は、表全体に対するロックが取得されます。行レベル・ロックは、最も粒度の高い並行性制御を提供するため、ほとんどのアプリケーションに対して最適です。行レベル・ロックを使用するには、アプリケーションでLockLevel接続属性を0(デフォルト値)に設定する必要があります。Oracle Database表をキャッシュするには、行レベル・ロックを設定する必要があります。ユーザーに対してCREATE、DROPまたはALTERを実行する場合、行レベル・ロックのみを使用できるため、これらの処理を実行する前にロック・レベルを0に設定する必要があります。

この接続であらゆるトランザクションがデータベースに排他アクセスできるように、LockLevel属性を1に設定してデータベース・レベル・ロックを有効にすることができます。これにより、アプリケーションによってはパフォーマンスが向上する場合もあります。

ttLockLevel組込みプロシージャをコールすることで、接続で、希望するロック・レベルを随時変更できます。また、ttLockWait組込みプロシージャをコールすることで、利用できないロックを待機することもできます。異なる接続は異なるレベルのロックと共存できますが、データベース・レベルのロックを使用する接続が1つでもある場合は、同時性が損なわれます。特定のデータベースのすべてのロックのリストを表示するには、ttXactAdminユーティリティを使用します。

アプリケーションでPL/SQLを使用する場合、LockLevel=0を設定し、ttLockLevel組込みプロシージャを使用して、データベース・レベル・ロックを必要とするトランザクションについてのみ、データベース・レベル・ロックに変更します。

必要な権限

この属性の値が1の場合はADMIN権限が必要です。

設定

LockLevelは次のように設定します。

属性の設定場所

属性の表示

設定

CまたはJavaプログラム、あるいはUNIX odbc.iniファイル

LockLevel

0 (デフォルト): トランザクションは行レベル・ロックを使用してデータベースにアクセスします。
1: トランザクションはデータベース全体の排他ロックを取得してデータベースにアクセスします。

Windows ODBCデータソース・アドミニストレータ

「DS-Level Locking」チェック・ボックス

選択解除(デフォルト): トランザクションは行レベル・ロックを使用してデータベースにアクセスします。
選択: トランザクションはデータベース全体の排他ロックを取得してデータベースにアクセスします。

LockWait

アプリケーションの接続中のロック待機時間を設定します。ロック待機時間は、ロックの競合が発生した際に待機する秒数です。小数秒を使用すると、わずかな秒数を表す際に重要な1秒未満のLockWait値を指定できます。次に例を示します。

LockWait = 0.1

これは、1/10秒の待機時間となります。

LockWaitには10分の数秒の精度で0から1,000,000の値を設定できます。デフォルトは10秒です。

LockWait = 10.0

タイムアウトを検出するエージェントのスケジュールにより、実際のロック待機応答時間は不正確で、最大1/10秒超過する場合があります。0(ゼロ)秒のタイムアウトの場合はこの不正確さは該当せず、タイムアウトはすぐにレポートされます。

データベースへの接続数は、ロック競合の解決にかかる時間に影響します。データベースへの接続数が多くなると予測される場合は、ロック待機時間を増やしてください。

キャッシュ・グリッドはロック待機時間とともにメッセージ待機時間を使用します。キャッシュ・グリッド使用時は、ロック待機時間は指定した値の約半分になります。アプリケーションでロック待機時間のすべてが必要な場合は、必要な秒数の2倍を指定します。

接続ではttLockWait組込みプロシージャをコールすることで、ロック待機時間をいつでも変更できます。

特定のデータベースに対するすべてのロックのリストを表示するには、TimesTenユーティリティttXactAdminを使用します。

必要な権限

この属性の値の変更に権限は必要ありません。

設定

LockWaitは次のように設定します。

属性の設定場所

属性の表示

設定

CまたはJavaプログラム、あるいはUNIX odbc.iniファイル

LockWait

s: タイムアウトが発生する前にロックの競合解消を待機する秒数を指定します。デフォルトは10秒です。

Windows ODBCデータソース・アドミニストレータ

「LockWait」フィールド

s: タイムアウトが発生する前にロックの競合解消を待機する秒数を指定します。デフォルトは10秒です。

MatchLogOpts

データベースの初期接続で、トランザクション・ログ・ファイルを消去するかどうかを決定します。後続の接続では、LogPurge属性に同じ値を指定する必要があり、指定しない場合は、TimesTenによってエラーが返されます。接続でLogPurge属性の現在の状態がわからない場合は、MatchLogOptsを設定すると、ロギング属性を一致させることができます。

注意:
初期接続でMatchLogOptsがTrueに設定されている場合は、TimesTenによってエラーが返され、接続は失敗します。MatchLogOpts接続属性での属性の使用には注意が必要です。

必要な権限

この属性の値の変更に権限は必要ありません。

設定

MatchLogOptsは次のように設定します。

属性の設定場所

属性の表示

設定

CまたはJavaプログラム、あるいはUNIX odbc.iniファイル

MatchLogOpts

0(デフォルト): LogPurgeの値が使用されます。
1: TimesTenではLogPurgeの値は無視されます。かわりに、値は現在のそれらの値と一致します。

Windows ODBCデータソース・アドミニストレータ

「Match Log Opts」チェック・ボックス

選択解除(デフォルト): LogPurgeの値が使用されます。
選択: TimesTenではLogPurgeの値は無視されます。かわりに、値は現在のそれらの値と一致します。

PermWarnThreshold

TimesTenがデータベースのメモリーの永続パーティションについてメモリー不足の警告を発行する、しきい値の割合を示します。このしきい値の10%下より低い割合まで下がると、データベースの永続メモリー不足は解消したものとみなされます。アプリケーションは、組込みプロシージャttWarnOnLowMemoryをコールしてメモリー不足の警告を受信する必要があります。また、しきい値はSNMP警告にも適用されます。『Oracle TimesTen In-Memory Databaseエラー・メッセージおよびSNMPトラップ』のSNMPトラップを使用した診断に関する説明も参照してください。

必要な権限

この属性の値の変更に権限は必要ありません。

設定

PermWarnThresholdは次のように設定します。

属性の設定場所

属性の表示

設定

CまたはJavaプログラム、あるいはUNIX odbc.iniファイル

PermWarnThreshold

p: TimesTenでメモリー不足警告が発行される割合です。デフォルトは90です。

Windows ODBCデータソース・アドミニストレータ

「Low Memory Warning Thresholds for Permanent Data」フィールド

p: TimesTenでメモリー不足警告が発行される割合です。デフォルトは90です。

PrivateCommands

複数の接続で同じコマンドを実行する場合、それらの接続は、1つのコマンド・ロックによって制御される共通のコマンド構造にアクセスします。コマンドの共有およびロックへの競合を回避するには、PrivateCommandsを使用します。これにより、一時領域の使用は増加しますが、スケールは改善されます。

デフォルトではPrivateCommandsは無効で、コマンドは共有されます。

必要な権限

この属性の値の変更に権限は必要ありません。

設定

PrivateCommandsは次のように設定します。

属性の設定場所

属性の表示

設定

CまたはJavaプログラム、あるいはUNIX odbc.iniファイル

PrivateCommands

0(デフォルト): コマンドは他の接続と共有されます。
1: コマンドは他の接続と共有されません。

Windows ODBCデータソース・アドミニストレータ

「Private Commands」フィールド

0(デフォルト): コマンドは他の接続と共有されます。
1: コマンドは他の接続と共有されません。

注意

同じコマンドのコピーが多数ある場合、それらのコピーはすべて、DDLまたは統計変更によって無効にされます。PrivateCommands = 1の場合、それらの複数のコピーを再度準備するには時間がかかります。コマンドが多い場合、DDLの実行にはやや長い時間がかかります。

PrivateCommands属性を使用する場合は、注意深く使用しないとメモリー消費が大幅に増大する可能性があります。たとえば、100のコマンドで100の接続があるアプリケーションでPrivateCommands=1を設定した場合、システムには10,000のコマンド、つまり各接続で1つの専用コマンドが存在します。

PWDCrypt

PWDCryptには対応するPWD値の暗号化された値が含まれています。PWDの値はクリアテキスト(特殊文字は使用不可)で、UNIXの場合は.odbc.iniファイルに、Windowsの場合はレジストリに保存されます。.odbc.iniファイルまたはWindowsのレジストリにアクセスできるすべてのユーザーがこの属性の値を参照できます。PWDCrypt属性では特殊文字を使用でき、大/小文字が区別され、暗号化されたパスワードの値が含まれています。

セキュリティ上の理由から、PWDCrypt属性はユーザーDSNまたはユーザー専用のODBCINIファイルに格納する必要があります。システムDSNにPWDCryptがある場合、すべてのユーザーはクリアテキスト・パスワードの知識がなくても、PWDCryptの値を使用してTimesTenに接続できます。

この属性の値を生成するには、ttUserユーティリティを実行します。

必要な権限

この属性の値の変更に権限は必要ありません。

注意

PWDとPWDCryptの両方が指定された場合、TimesTenではPWD属性の値が使用されます。「UIDおよびPWD」を参照してください。

TimesTenでは、TimesTenシステムのどこにもPWD属性の値を保存しません。

特定の権限を必要とするユーティリティを使用した場合のパスワード処理の詳細は、「UIDおよびPWD」の項の「ユーティリティに必要なユーザー認証」を参照してください。

設定

PWDCryptは次のように設定します。

属性の設定場所

属性の表示

設定

CまたはJavaプログラム、あるいはUNIX odbc.iniファイル

PWDCrypt

ttUserユーティリティによって生成された値を入力します。

Windows ODBCデータソース・アドミニストレータ

「PWDCrypt」フィールド

ttUserユーティリティによって生成された値を入力します。

QueryThreshold

SQL文の実行時間が指定した値を超えたときに、サポート・ログに警告を書き込み、SNMPトラップをスローする際にこの属性を使用します。レプリケーション・エージェントによって実行される問合せについては、『Oracle TimesTen In-Memory Database開発者および管理者ガイド』を参照してください。キャッシュ・エージェントによって実行されるSQL文には、問合せしきい値を設定できません。QueryThresholdの値は、すべての接続に適用されます。この値は、レプリケーション・エージェントまたはキャッシュ・エージェントによって実行されるSQL文を除いて、すべてのSQL文に適用されます。

この属性の値には、0(ゼロ)以上の任意の整数を指定できます。デフォルト値は0です。値が0 (ゼロ)の場合は警告が発行されないことを示します。秒単位で指定します。

必要な権限

この属性の値の変更に権限は必要ありません。

設定

QueryThresholdは次のように設定します。

属性の設定場所

属性の表示

設定

CまたはJavaプログラム、あるいはUNIX odbc.iniファイル

QueryThreshold

負ではない整数です。デフォルトは0 (ゼロ)であり、TimesTenが警告を返さないことを示します。

Windows ODBCデータソース・アドミニストレータ

「QueryThreshold (secs)」フィールド

負ではない整数です。デフォルトは0 (ゼロ)であり、TimesTenが警告を返さないことを示します。

ReplicationTrack

追跡ベース・パラレル・レプリケーションを管理する場合、レプリケーション追跡に接続を割り当てることができます。接続によって発行されたすべてのトランザクションは、追跡が変更されないかぎり、この追跡に割り当てられます。

追跡ベース・パラレル・レプリケーションを開始するには、ReplicationParallelism属性の値を設定して、パラレルで適用されるレプリケーションの追跡数を指定する必要があります。自動またはユーザー定義のパラレル・レプリケーションを使用するかどうかに応じて、ReplicationApplyOrderingを1または2のいずれかに設定する必要もあります。

TTREP.REPPEERSシステム表のTrack_ID列(『Oracle TimesTen In-Memory Databaseシステム表およびビュー・リファレンス』を参照)は、接続に関連付けられているトラックを示します。

ALTER SESSION SQL文(『Oracle TimesTen In-Memory Database SQLリファレンス』を参照)を使用して、セッション内でこの属性の値を割当てまたは変更できます。次に例を示します。

ALTER SESSION SET REPLICATION_TRACK=4;

必要な権限

この属性の値の変更に権限は必要ありません。

設定

ReplicationTrackは次のように設定します。

属性の設定場所

属性の表示

設定

CまたはJavaプログラム、あるいはUNIX odbc.iniファイル

ReplicationTrack

n: 接続によって発行されるトランザクションで使用するレプリケーション追跡を指定するための1から64の整数です。

Windows ODBCデータソース・アドミニストレータ

「Replication Track」フィールド

n: 接続によって発行されるトランザクションで使用するレプリケーション追跡を指定するための1から64の整数です。

Restrictions

ユーザー指定のパラレル・レプリケーションを指定する場合の制限および注意事項は、次のとおりです。

- TWOSAFEレプリケーションおよびRETURN RECEIPTレプリケーションを含む同期レプリケーションは、ユーザー指定のパラレル・レプリケーションではサポートされていません。

- アクティブ・スタンバイ・ペアはユーザー指定のパラレル・レプリケーションではサポートされていません。

SQLQueryTimeout

データベースがSQL文を実行する必要がある制限時間(秒単位)を指定するには、この属性を使用します。

SQLQueryTimeoutの値には、0(ゼロ)以上の任意の整数を指定できます。デフォルト値は0です。値が0 (ゼロ)の場合は問合せがタイムアウトしないことを示します。

この属性によって、Oracle Databaseで処理中のTimesTen Cache操作が停止されることはありません。このような操作には、PassThrough文、フラッシング、手動ロード、手動リフレッシュ、同期ライトスルーおよび伝播が含まれます。

必要な権限

この属性の値の変更に権限は必要ありません。

設定

SQLQueryTimeoutは次のように設定します。

属性の設定場所

属性の表示

設定

CまたはJavaプログラム、あるいはUNIX odbc.iniファイル

SQLQueryTimeout

n: データベースがSQL問合せを実行する必要がある制限時間(秒単位)です。

Windows ODBCデータソース・アドミニストレータ

「QueryTimeout (secs)」フィールド

n: データベースがSQL問合せを実行する必要がある制限時間(秒単位)です。

TempWarnThreshold

TimesTenがデータベースのメモリーの一時パーティションについてメモリー不足の警告を発行する、しきい値の割合を示します。このしきい値の10%下より低い割合まで下がると、データベースの一時メモリー不足は解消したものとみなされます。アプリケーションは、組込みプロシージャttWarnOnLowMemoryをコールしてメモリー不足の警告を受信する必要があります。また、しきい値はSNMP警告にも適用されます。「ttWarnOnLowMemory」を参照してください。『Oracle TimesTen In-Memory Databaseエラー・メッセージおよびSNMPトラップ』のSNMPトラップを使用した診断に関する説明も参照してください。

必要な権限

この属性の値の変更に権限は必要ありません。

設定

TempWarnThresholdは次のように設定します。

属性の設定場所

属性の表示

設定

CまたはJavaプログラム、あるいはUNIX odbc.iniファイル

TempWarnThreshold

p: 警告が発行される割合です。デフォルトは90です。

Windows ODBCデータソース・アドミニストレータ

「Low Memory Warning Thresholds for Temporary Data」フィールド

p: 警告が発行される割合です。デフォルトは90です。

UIDおよびPWD

ユーザーIDおよびパスワードは、TimesTenに内部的に識別されるユーザーが入力する必要があります。または、PWDCrypt属性を使用して、暗号化されたパスワードを入力することができます。TimesTenの処理によっては、処理を実行するユーザーのUIDとPWDを要求されることがあります。

TimesTenクライアント/サーバー・アプリケーションでは、UIDおよびPWDは、クライアントDSN設定または接続文字列のいずれかで指定します。接続文字列で指定されたUIDおよびPWDの値は、クライアントDSN設定で指定された値より優先されます。

Oracle Database表をキャッシュする場合、PWDはTimesTenのパスワードを指定し、OraclePWDはOracleのパスワードを指定します。

ユーティリティに必要なユーザー認証

パスワードを必要とするすべてのユーティリティでは、パスワードを入力するように要求されます。

接続文字列によって、または指定されたDSNのODBCINIファイル内で、UID接続属性は指定されているがPWD属性が指定されていない場合は、TimesTenによってパスワードの入力が要求されます。明示的に要求された場合には、入力内容はコマンドラインに表示されません。

TimesTenでパスワードの入力が要求される前にコマンドラインに入力したパスワードは、psコマンドによって表示されるため、ユーティリティの最初のコールでPWD接続属性を使用することはお薦めしません。たとえば、次のような使用方法はお薦めしません。

% ttIsql -connStr "DSN=mydsn;UID=terry;PWD=secret";

一般に、UID接続属性が指定されていない場合、UIDはオペレーティング・システムで識別されるユーザー名とみなされ、TimesTenでパスワードを入力するように求められることはありません。

ユーティリティでDSN、接続文字列またはデータベース・パスをパラメータとして使用する場合は、コマンドラインの末尾に値を指定します。

必要な権限

これらの属性の値の変更に権限は必要ありません。

設定

UIDおよびPWDは次のように設定します。

属性の設定場所

属性の表示

設定

CまたはJavaプログラム、あるいはUNIX odbc.iniファイル

UID

ユーザーIDを指定する文字列です。

CまたはJavaプログラム、あるいはUNIX odbc.iniファイル

PWD

ユーザーIDに対応するパスワードを指定する文字列です。

Windows ODBCデータソース・アドミニストレータ

「User ID」フィールド

ユーザーIDを指定する文字列です。

WaitForConnect

アプリケーションがTimesTenデータベースへの接続を要求したときに、データベースの同時ロード/リカバリなどが原因で接続できない場合、通常、TimesTenは競合している接続が完了するまで待機します。場合によっては、アプリケーションがデータベースに接続するのに時間がかかることがあります。WaitForConnect属性をオフに設定しておくと、データベースにすぐに接続できない場合、TimesTenはただちにエラーを返します。エラーの説明については、『Oracle TimesTen In-Memory Databaseエラー・メッセージおよびSNMPトラップ』の警告およびエラーに関する項で該当するエラー・メッセージ番号の説明を参照してください。

必要な権限

この属性の値の変更に権限は必要ありません。

設定

WaitForConnectは次のように設定します。

属性の設定場所

属性の表示

設定

CまたはJavaプログラム、あるいはUNIX odbc.iniファイル

WaitForConnect

0: データベースへの接続が失敗した場合、待機しません。
1(デフォルト): データベースへの接続が可能になるまで待機します。

Windows ODBCデータソース・アドミニストレータ

「Wait For Connect」チェック・ボックス

選択解除: データベースへの接続が失敗した場合、待機しません。
選択(デフォルト): データベースへの接続が可能になるまで待機します。

NLS一般接続属性

NLS接続属性は各接続によって設定され、接続が継続している間持続します。これらの属性は、データベースのグローバリゼーションの動作を制御します。この項では、表1-4「NLS一般接続属性」に示したNLS一般接続属性について説明します。

ALTER SESSION文(『Oracle TimesTen In-Memory Database SQLリファレンス』を参照)を使用して、NLSパラメータを変更し、接続時にこれらの属性に割り当てられる値を上書きできます。

ConnectionCharacterSet

ConnectionCharacterSetは、クライアントの接続属性としても使用できます。

この属性は、接続用の文字コードを指定しますが、データベース・キャラクタ・セットとは異なる文字コードを指定することができます。これは、データベースへの接続が複数あるときや、そのうちの1つ以上の接続でデータベースで指定されているものとは異なるキャラクタ・セットが必要な場合に便利です。

接続キャラクタ・セットにより、データが表示または参照される際のキャラクタ・セットが決定されます。

通常、ご使用の端末の設定またはデータソースと一致する接続キャラクタ・セットを選択する必要があります。データ要件に基づいて、データベースのキャラクタ・セットを選択することが必要です。たとえば、データをUnicodeで使用するか、UNIX(EUC)またはWindows(SJIS)上で日本語として使用するかを選択します。

データベースのキャラクタ・セットと接続キャラクタ・セットが異なる場合、TimesTenは、接続キャラクタ・セットに従って内部的にデータを変換します。接続およびデータベースのキャラクタ・セットが同じ場合、TimesTenはデータ・セットを変換したり解釈する必要はありません。接続およびデータベースのキャラクタ・セットが一致していると、変換の必要がないため、最高のパフォーマンスを得られます。

パラメータおよびSQL問合せのテキストを接続に送信するには、接続キャラクタ・セットであることが必要です。接続中に返される結果やエラー・メッセージは、接続キャラクタ・セットとして返されます。

TIMESTEN8キャラクタ・セット用のキャラクタ・セットの変換はサポートされていません。TIMESTEN8のConnectionCharacterSetの値は、TIMESTEN8ではないDatabaseCharacterSetに割り当てられるとエラーになります。

この属性は、DatabaseCharacterSet用に使用される値と同じ値を使用します。サポートされているキャラクタ・セット名のリストは、「サポートされているキャラクタ・セット」を参照してください。

必要な権限

この属性の値の変更に権限は必要ありません。

設定

ConnectionCharacterSetは次のように設定します。

属性の設定場所

属性の表示

設定

CまたはJavaプログラム、あるいはUNIX odbc.iniファイル

ConnectionCharacterSet

データベースで使用するキャラクタ・セットがTIMESTEN8の場合を除き、ConnectionCharacterSetのデフォルト値はUS7ASCIIです。

Windows ODBCデータソース・アドミニストレータ

「Connection CharacterSet」リスト

データベースで使用するキャラクタ・セットがTIMESTEN8の場合を除き、ConnectionCharacterSetのデフォルト値はUS7ASCIIです。

NLS_LENGTH_SEMANTICS

TimesTenではNLS_LENGTH_SEMANTICS属性を使用して、長さセマンティクス構成のデフォルトを設定します。長さセマンティクスを設定することで、キャラクタ文字列の長さがどのように定義されるかが決まります。長さは文字列(バイト数)として処理できます。

必要な権限

この属性の値の変更に権限は必要ありません。

設定

NLS_LENGTH_SEMANTICSは次のように設定します。

属性の設定場所

属性の表示

設定

CまたはJavaプログラム、あるいはUNIX odbc.iniファイル

NLS_LENGTH_ SEMANTICS

BYTE(デフォルト)またはCHARのいずれかを指定します。

Windows ODBCデータソース・アドミニストレータ

「NLS_LENGTH_SEMANTICS」リスト

BYTE(デフォルト)またはCHARのいずれかを選択します。

NLS_NCHAR_CONV_EXCP

NLS_NCHAR_CONV_EXCP属性は、NCHAR/NVARCHAR2データとCHAR/VARCHAR2データの間で暗黙的または明示的なキャラクタ・タイプの変換が行われる際、データ損失が発生した場合にエラーを報告するかどうかを指定します。変換できない文字には置換文字が代用されます。

データベースで使用するキャラクタ・セットがTIMESTEN8の場合を除き、CHARとNCHARの間で暗黙的または明示的な変換がサポートされています。

必要な権限

この属性の値の変更に権限は必要ありません。

設定

NLS_NCHAR_CONV_EXCPは次のように設定します。

属性の設定場所

属性の表示

設定

CまたはJavaプログラム、あるいはUNIX odbc.iniファイル

NLS_NCHAR_CONV_EXCP

0 (デフォルト): キャラクタ・タイプの変換時にデータ損失が発生した場合、エラーを報告しません。
1: キャラクタ・タイプの変換時にデータ損失が発生した場合、エラーを報告します。

Windows ODBCデータソース・アドミニストレータ

「NLS_NCHAR_ CONV_EXCP」チェック・ボックス

選択解除(デフォルト): キャラクタ・タイプの変換時にデータ損失が発生した場合、エラー・メッセージを報告しません。
選択: キャラクタ・タイプの変換時にデータ損失が発生した場合、エラー・メッセージを報告します。

NLS_SORT

NLS_SORT属性では、言語比較に使用する照合順番を指定します。「サポートされている言語ソート」に示されている値を使用できます。これらの値はいずれも各値に_CIを付加することで、大/小文字を区別せずにソートを実行するように変更できます。アクセント記号および大/小文字を区別せずにソートするには、値に_AIを付加します。

TimesTenでは、マテリアライズド・ビューおよびキャッシュ・グループに対して、この属性を接続文字列またはDSN定義で使用するのではなく、SQL関数のNLSSORTを使用して照合順番を明示的に指定することをお薦めします。

文字比較を含む演算では、言語の大/小文字を区別する照合順番がサポートされています。大/小文字を区別しないソートは、DISTINCT値の解釈に影響することがあります。

NLS_SORTを行うと、様々な処理に影響する可能性があります。照合順番を区別する、サポートされている処理は次のとおりです。

- MIN、MAX

- BETWEEN

- =、<>、>、>=、<、<=

- DISTINCT

- CASE

- GROUP BY

- HAVING

- ORDER BY

- IN

- LIKE

TIMESTEN8キャラクタ・セットでは、BINARYソートのみがサポートされています。

BINARY以外のNLS_SORT設定を行うと、文字処理のパフォーマンスに重大な影響を及ぼす可能性があります。

注意:
主キー索引は常にBINARY照合順番に従います。BINARY以外のNLS_SORT等価検索では、主キー索引を使用できません。

必要な権限

この属性の値の変更に権限は必要ありません。

設定

NLS_SORTは次のように設定します。

属性の設定場所

属性の表示

設定

CまたはJavaプログラム、あるいはUNIX odbc.iniファイル

NLS_SORT

言語のソート順序またはBINARY(デフォルト)を指定します。

Windows ODBCデータソース・アドミニストレータ

「NLS_SORT」ドロップダウン・リスト

言語のソート順序またはBINARY(デフォルト)を指定します。

サポートされている言語ソート

この項の各表は、NLS_SORT一般接続属性およびNLS_SORTのSQL関数でサポートされている値を示します。

単一言語ソート

基本名

拡張名

ARABIC

-

ARABIC_MATCH

-

ARABIC_ABJ_SORT

-

ARABIC_ABJ_MATCH

-

ASCII7

-

AZERBAIJANI

XAZERBAIJANI

BENGALI

-

BIG5

-

BINARY

-

BULGARIAN

-

CANADIAN FRENCH

-

CATALAN

XCATALAN

CROATIAN

XCROATIAN

CZECH

XCZECH

CZECH_PUNCTUATION

XCZECH_PUNCTUATION

DANISH

XDANISH

DUTCH

XDUTCH

EBCDIC

-

EEC_EURO

-

EEC_EUROPA3

-

ESTONIAN

-

FINNISH

-

FRENCH

XFRENCH

GERMAN

XGERMAN

GERMAN_DIN

XGERMAN_DIN

GBK

-

GREEK

-

HEBREW

-

HKSCS

-

HUNGARIAN

XHUNGARIAN

ICELANDIC

-

INDONESIAN

-

ITALIAN

-

LATIN

-

LATVIAN

-

LITHUANIAN

-

MALAY

-

NORWEGIAN

-

POLISH

-

PUNCTUATION

XPUNCTUATION

ROMANIAN

-

RUSSIAN

-

SLOVAK

XSLOVAK

SLOVENIAN

XSLOVENIAN

SPANISH

XSPANISH

SWEDISH

-

SWISS

XSWISS

THAI_DICTIONARY

-

TURKISH

XTURKISH

UKRAINIAN

-

UNICODE_BINARY

-

VIETNAMESE

-

WEST_EUROPEAN

XWEST_EUROPEAN

多言語ソート

ソート名

説明

CANADIAN_M

フランス語(カナダ)ソート。補助的な特殊拡張文字が逆順でソートされます。

DANISH_M

デンマーク語ソート。小文字より前に大文字がソートされます。

FRENCH_M

フランス語ソート。補助的な文字が逆順でソートされます。

GENERIC_M

ISO14651およびUnicode標準等価性ルールに基づく一般的なソート順序。ただし、互換等価性ルールは除きます。

JAPANESE_M

日本語のソートは、SJISキャラクタ・セットのソート順序およびSJISには含まれないEUC文字をサポートしています。

KOREAN_M

韓国語のソートでは、ハングル文字はUnicodeのバイナリ順序に基づいてソートされます。ハンジャ文字は発音順に基づいてソートします。すべてのハングル文字がハンジャ文字の前にソートされます。

SPANISH_M

スペイン語ソート(トラディショナル・ソート)。特殊な短縮文字がソートされます。

THAI_M

タイ語ソート。一部の母音と子音に対する入替え文字がソートされます。

SCHINESE_RADICAL_M

簡体字中国語ソート。プライマリ順序として部首が使用され、セカンダリ順序として画数が使用されます。

SCHINESE_STROKE_M

簡体字中国語ソート。プライマリ順序として画数が使用され、セカンダリ順序として部首が使用されます。

SCHINESE_PINYIN_M

簡体字中国語ソート。順序としてピンインが使用されます。

TCHINESE_RADICAL_M

繁体字中国語ソート。プライマリ順序として部首が使用され、セカンダリ順序として画数が使用されます。

TCHINESE_STROKE_M

簡体字中国語ソートでは、プライマリ順序として画数が使用され、セカンダリ順序として部首が使用されます。補助文字もサポートされています。

PL/SQLの初期接続属性

PL/SQL接続属性は各接続によって設定され、接続が継続している間持続します。これらの属性によって、データベースの動作が制御されます。この項では、表1-5「PL/SQLの初期接続属性」に示したPL/SQLの初期接続属性について説明します。

PLSQL

この属性は、データベースに対してPL/SQLを構成するかどうかを指定します。

PLSQL=1を指定すると、データベースでPL/SQLの使用を有効にします。PLSQL=0を指定すると、データベースでPL/SQLの使用を無効にします。

インストール時にPL/SQLサポートが有効になっているTimesTenインストールの場合、デフォルトはPLSQL=1です。または、データベースを最初に作成するとき、または後で初期接続時にPL/SQLを有効にできます。一度データベースでPL/SQLサポートを有効にすると、後で無効にすることはできません。

データベースでPL/SQLサポートを構成すると、いくつかのPL/SQLパッケージがインストールされます(『Oracle TimesTen In-Memory Database PL/SQLパッケージ・リファレンス』を参照)。

この属性を設定する場合の注意事項は、次のとおりです。

- PL/SQLが有効になっているデータベースにアプリケーションが接続する場合に、アプリケーションまたはodbc.iniファイルでPLSQL=0が指定されていると、TimesTenによって警告が返されます。

- PL/SQLが有効になっていないデータベースにアプリケーションが接続する場合に、アプリケーションまたはodbc.iniファイルでPLSQL=1が指定されていると、この接続が初期接続か後続の接続かによって結果が異なります。最初の接続の場合、データベースはPL/SQLをサポートするように構成されます。それ以外の場合は、TimesTenによってエラーが返されます。

- PLSQL=0の場合、PL/SQLの初期接続属性および一般接続属性はすべて無視されます。

- PLSQL=0の場合、PL/SQL一般接続属性の値を変更しようとするとエラーが返されます。

- PLSQL=1の場合、その接続に対してLockLevel=0に設定することをお薦めします。データベース・レベル・ロックが有効な場合、一部のPL/SQL内部ファンクションは実行できません。ttLockLevel組込みプロシージャを使用して、データベース・レベル・ロックを必要とするトランザクションについてのみ、データベース・レベル・ロックに変更できます。

- PL/SQLサポートが有効な場合、DDLCommitBehaviorをOracleのトランザクション・コミット動作(値0)に設定する必要があります。

- PL/SQLを有効にすると(PLSQL=1)、PL/SQLを使用していなくても、PL/SQLセグメントから割り当てられた固定オーバーヘッドおよび接続ごとのオーバーヘッドの両方が存在することになります。詳細は、「PLSQL_MEMORY_SIZE」を参照してください。

必要な権限

インスタンス管理者のみがこの属性の値を変更できます。

設定

PLSQLは次のように設定します。

属性の設定場所

属性の表示

設定

CまたはJavaプログラム、あるいはUNIX odbc.iniファイル

PLSQL

0: データベースに対してPL/SQLを有効にしないことを示します。
1(デフォルト): データベースに対してPL/SQLを有効にします。

Windows ODBCデータソース・アドミニストレータ

「PL/SQL Enabled」チェック・ボックス

選択: データベースに対してPL/SQLを有効にします。
選択解除: データベースに対してPL/SQLを有効にしないことを示します。

PLSQL_MEMORY_ADDRESS

PL/SQLを使用するには、共有メモリー・セグメントが必要です。この共有メモリーには、最近実行されたPL/SQLコード、共有パッケージの状態およびPL/SQLの処理に関連付けられたメタデータが格納されます。この共有メモリー・セグメントは、TimesTenデータベースを格納するセグメントとは別の共有メモリー・セグメントです。

この属性は、この共有メモリー・セグメントが、TimesTenダイレクト・ドライバを利用する各プロセスにロードされる仮想アドレスを指定します。このメモリー・アドレスは、TimesTenを使用中の各プロセスで同一である必要があります。値は16進のアドレスとして指定する必要があります。

PL/SQLの使用が有効になっている場合(PLSQL=1)に、PLSQL_MEMORY_ADDRESSに値を指定しないと、TimesTenではプラットフォーム依存のデフォルト値が使用されます。

各プラットフォームのデフォルト値は、次のように設計されています。

1. TimesTenデータベースおよびアプリケーションの仮想領域の容量を最大限に高める。

2. 仮想アドレス領域の断片化を最小限に抑える。

3. 仮想アドレス領域の他の利用との競合を避ける。

プラットフォーム固有のデフォルトのメモリー・アドレスは、次のとおりです。

オペレーティング・システム

アドレス

32ビットx86プロセッサ上のLinux

10000000

64ビットx86プロセッサ上のLinux

0000007fa0000000

32ビットAIX

c0000000

64ビットAIX

06ffffff00000000

64ビットx86プロセッサ上のSolaris

0000007fa0000000

64ビットSPARCプロセッサ上のSolaris

ffffff0000000000

32ビットWindows

5B8C0000

64ビットWindows

000000005b8c0000

64ビットHP-UX

0

この属性を設定する場合の注意事項は、次のとおりです。

- アプリケーションが複数のTimesTenデータベースにダイレクト・モードで同時に接続する場合、各データベースはPLSQL_MEMORY_ADDRESSに対して異なる値を使用する必要があります。

- この属性の値は、TimesTenによって永続的に保存されます。データベースがTimesTenによって自動的にロードされる状況において、永続的な属性値が指定されます。たとえば、データベースのRamPolicyが1に設定されている場合、データベースは自動的にロードされます。

- PL/SQL共有メモリーを適切なアドレスでマップできない場合、TimesTenによってエラーが返され、データベースへの接続は失敗します。

- メモリー・セグメントのサイズは、PLSQL_MEMORY_SIZEの値によって決定されます。

必要な権限

インスタンス管理者のみがこの属性の値を変更できます。

設定

PLSQL_MEMORY_ADDRESSは次のように設定します。

属性の設定場所

属性の表示

設定

CまたはJavaプログラム、あるいはUNIX odbc.iniファイル

PLSQL_MEMORY_ADDRESS

PL/SQLプロセス用のメモリー・アドレスを指定する16進値。

Windows ODBCデータソース・アドミニストレータ

「PL/SQL Memory Address」フィールド

PL/SQLプロセス用のメモリー・アドレスを指定する16進値。

PLSQL_MEMORY_SIZE

PL/SQLを使用するには、共有メモリー・セグメントが必要です。この属性は、PL/SQLで使用される共有メモリー・セグメントのサイズをMB単位で指定します。すべての接続でこのメモリー・セグメントを共有します。

この共有メモリーには、最近実行されたPL/SQLコード、共有パッケージの状態およびPL/SQLの処理に関連付けられたメタデータが格納されます。この共有メモリー・セグメントは、TimesTenデータベースを格納するセグメントとは別の共有メモリー・セグメントです。

この属性を設定する場合の注意事項は、次のとおりです。

- この属性の値は、TimesTenによって永続的に保存されます。データベースがTimesTenによって自動的にロードされる状況において、永続的な属性値が指定されます。たとえば、データベースのRamPolicyが1に設定されている場合、データベースは自動的にロードされます。

- メモリーのデフォルト・サイズは、UNIXシステムは32MB、Windows 32ビット・システムは32MBです。PLSQL=1の場合、最小サイズは2MBです。ほとんどのPL/SQLユーザーにとっては、このデフォルト・サイズは十分なメモリー量です。PL/SQLを大量に使用するデータベースの場合は、より大きいメモリー・サイズを指定します。メモリー領域に空きがなくなると、PL/SQLの実行中にORA-4031エラーが発生する可能性があります。

- メモリー・セグメントのアドレスは、PLSQL_MEMORY_ADDRESSの値によって決定されます。

- PL/SQLを有効にすると(PLSQL=1)、PL/SQLを使用していなくても、PL/SQLセグメントから割り当てられた固定オーバーヘッドおよび接続ごとのオーバーヘッドの両方が存在することになります。割り当てられる最小の固定メモリーは約1500KBです。さらに、接続ごとに約40KBのメモリーが割り当てられます。したがって、PL/SQLを有効にする場合のPLSQL_MEMORY_SIZEに必要な推定の最小メモリー設定は、1500KB + (接続数×40)として計算できます。アプリケーションでPL/SQLを使用する場合は、このセグメントに必要な推定の最小メモリーの2倍を割り当てることをお薦めします。アプリケーションでPL/SQLを使用しない場合は、必要な推定の最小メモリーの2倍よりも少なく割り当てることができます。

必要な権限

インスタンス管理者のみがこの属性の値を変更できます。

設定

PLSQL_MEMORY_SIZEは次のように設定します。

属性の設定場所

属性の表示

設定

CまたはJavaプログラム、あるいはUNIX odbc.iniファイル

PLSQL_MEMORY_SIZE

共有メモリー・セグメントのサイズをMB単位で表す、2より大きい正の整数をMB単位で指定します。デフォルト・サイズは32です。

Windows ODBCデータソース・アドミニストレータ

「PL/SQL Memory Size」フィールド

共有メモリー・セグメントのサイズをMB単位で表す、2より大きい正の整数をMB単位で指定します。デフォルト・サイズは32です。

PL/SQLの一般接続属性

PL/SQLの一般接続属性は各接続によって設定され、接続が継続している間持続します。これらの属性によって、データベースの動作が制御されます。この項では、表1-6「PL/SQLの一般接続属性」に示したPL/SQLの一般接続属性について説明します。

ALTER SESSION文(『Oracle TimesTen In-Memory Database SQLリファレンス』を参照)を使用して、PL/SQLパラメータを変更し、接続時にPL/SQLの一般接続属性に割り当てられる値を上書きできます。

PLSCOPE_SETTINGS

PLSCOPE_SETTINGSは、PL/SQLコンパイラで相互参照情報を生成するかどうかを制御します。すべての相互参照を生成するか、または1つも生成しないかのいずれかになります。

この属性を設定する場合の注意事項は、次のとおりです。

- PLSCOPE_SETTINGS接続属性によって、セッション内のこの属性の初期値が決定されます。この値は、ALTER SESSION文(『Oracle TimesTen In-Memory Database SQLリファレンス』を参照)によって変更される可能性があります。PLSQL=0のデータベースでALTER SESSION文にこの属性が指定されていない場合は、エラーが返されます。次に例を示します。

ALTER SESSION SET PLSCOPE_STTINGS = 'IDENTIFIERS:ALL' ;

- 接続文字列またはodbc.iniファイルでこの属性が指定されていないときに、アプリケーションがPLSQL=0のデータベースに接続すると、エラーまたは警告は生成されません。

注意:
この属性の詳細は、Oracle TimesTen In-Memory Database PL/SQL開発者ガイドを参照してください。

必要な権限

この属性の値の変更に権限は必要ありません。

設定

PLSCOPE_SETTINGSは次のように設定します。

属性の設定場所

属性の表示

設定

CまたはJavaプログラム、あるいはUNIX odbc.iniファイル

PLSCOPE_SETTINGS

IDENTIFIERS:NONE (デフォルト)
IDENTIFIERS:ALL

Windows ODBCデータソース・アドミニストレータ

「PLScope settings」プルダウン・リスト

IDENTIFIERS:NONE (デフォルト)
IDENTIFIERS:ALL

PLSQL_CCFLAGS

この属性では、PL/SQLユニットの条件付きコンパイルを制御するディレクティブを設定し、確認する条件に応じて、PL/SQLプログラムの機能をカスタマイズできます。このことは、特に、アプリケーションが複数のデータベース環境にデプロイされる場合に有効です。考えられる用途としては、デバッグ機能やトレース機能のアクティブ化、データベースのバージョンに基づいた機能設定などがあります。

次の形式を使用します。

PLSQL_CCFLAGS = 'v1:c1,v2:c2,...,vn:cn'

v1の形式は、引用符で囲まないPL/SQL識別子です。制限はなく、予約語やキーワードも可能です。このテキストでは大/小文字は区別されません。それぞれがフラグまたはフラグ名として認識されます。各viは、文字列内で複数回使用可能で、それぞれに異なるフラグ値を持つことができ、様々な種類のフラグ値を使用できます。

c1は、PL/SQLブール・リテラル、PLS_INTEGERリテラル、リテラルNULLのいずれかです。このテキストでは大/小文字は区別されません。それぞれがフラグ値として認識され、フラグ名に対応しています。

必要な権限

この属性の値の変更に権限は必要ありません。

設定

PLSQL_CCFLAGSは次のように設定します。

属性の設定場所

属性の表示

設定

CまたはJavaプログラム、あるいはUNIX odbc.iniファイル

PLSQL_CCFLAGS

次の形式の文字列リテラル:
'v1:c1,v2:c2,...,vn:cn'

デフォルト: NULL

Windows ODBCデータソース・アドミニストレータ

「PL/SQL CCFlags」フィールド

次の形式の文字列リテラル:
'v1:c1,v2:c2,...,vn:cn'

デフォルト: NULL

ALTER SESSION SQL文(『Oracle TimesTen In-Memory Database SQLリファレンス』を参照)を使用して、セッション内でこの属性を変更できます。

ALTER SESSION SET PLSQL_CCFLAGS = 'v1:c1,v2:c2,...,vn:cn';

PLSQL_CONN_MEM_LIMIT

この属性では、設定された接続でPL/SQLが使用できるプロセス・ヒープ・メモリーの最大量をMB単位で指定します。

この属性を設定する場合の注意事項は、次のとおりです。

- PL/SQLでは、必要となるまで(必要とならないかぎり)このメモリーは割り当てられません。多くのPL/SQLプログラムでは、必要なメモリー量はごく少量です。アプリケーションをどのように記述するかによって、メモリー要件が決定されます。たとえば、PL/SQLコードにサイズの大きなVARRAYが含まれる場合、大量のメモリーが必要になることがあります。

- 使用可能な量よりも大きいメモリーを割り当てようとすると、TimesTenによってエラーが返されます。

- この値は、ALTER SESSION文(『Oracle TimesTen In-Memory Database SQLリファレンス』を参照)を使用して変更できます。次に例を示します。

ALTER SESSION SET PLSQL_CONN_MEM_LIMIT = 100;

詳細は、『Oracle TimesTen In-Memory Database PL/SQL開発者ガイド』を参照してください。

必要な権限

この属性の値の変更に権限は必要ありません。

設定

PLSQL_CONN_MEM_LIMITは次のように設定します。

属性の設定場所

属性の表示

設定

CまたはJavaプログラム、あるいはUNIX odbc.iniファイル

PLSQL_CONN_MEM_LIMIT

MB単位の整数値。デフォルト値は100です。

Windows ODBCデータソース・アドミニストレータ

「PL/SQL Connection Memory Limit」フィールド

MB単位の整数値。デフォルト値は100です。

PLSQL_OPTIMIZE_LEVEL

この属性は、PL/SQLライブラリ・ユニットのコンパイルに使用する最適化レベルを指定します。このパラメータの設定が高いほど、コンパイラはPL/SQLライブラリ・ユニットをより最適化しようと試みます。

この属性を設定する場合の注意事項は、次のとおりです。

- PLSQL_OPTIMIZE_LEVEL接続属性によって、セッション内のこの属性の初期値が決定されます。この値は、ALTER SESSION文(『Oracle TimesTen In-Memory Database SQLリファレンス』を参照)によって変更される可能性があります。PLSQL=0のデータベースでALTER SESSION文にこの属性が指定されていない場合は、エラーが返されます。次に例を示します。

ALTER SESSION SET PLSQL_OPTIMIZE_LEVEL = 2;

- 接続文字列またはodbc.iniファイルでこの属性が指定されていないときに、アプリケーションがPLSQL=0のデータベースに接続すると、エラーまたは警告は生成されません。

必要な権限

この属性の値の変更に権限は必要ありません。

設定

PLSQL_OPTIMIZE_LEVELは次のように設定します。

属性の設定場所

属性の表示

設定

CまたはJavaプログラム、あるいはUNIX odbc.iniファイル

PLSQL_OPTIMIZE_LEVEL

この属性の設定の詳細は、Oracle TimesTen In-Memory Database PL/SQL開発者ガイドを参照してください。
デフォルト値は2です。

Windows ODBCデータソース・アドミニストレータ

「PL/SQL Optimization Level」プルダウン・リスト

この属性の設定の詳細は、Oracle TimesTen In-Memory Database PL/SQL開発者ガイドを参照してください。
デフォルト値は2です。

PLSQL_TIMEOUT

この属性は、PL/SQLプロシージャ、無名ブロックおよび関数を含むPL/SQLプログラム・ユニットが自動的に終了されるまでの実行時間を秒数で指定します。

この値は、ALTER SESSION文(『Oracle TimesTen In-Memory Database SQLリファレンス』を参照)によって変更される可能性があります。この値がALTER SESSIONによって変更された場合、新しい値は現在実行中のすべてのPL/SQLプログラム・ユニットに影響します。次に例を示します。

ALTER SESSION SET PLSQL_TIMEOUT = 10;

注意:

- PL/SQLを使用している場合は、PLSQL_TIIMEOUTの値をTTC_TIMEOUTマイナス5秒以下に設定してください。.

- PL/SQLプログラムが、このタイムアウト値に対して実行時間をチェックする間隔は変更可能です。プログラムをタイムアウト値よりも大幅に長い時間実行してから終了できます。

必要な権限

この属性の値の変更に権限は必要ありません。

設定

PLSQL_TIMEOUTは次のように設定します。

属性の設定場所

属性の表示

設定

CまたはJavaプログラム、あるいはUNIX odbc.iniファイル

PLSQL_TIMEOUT

タイムアウト値の秒数を表す正の整数。
値0 (ゼロ)は、タイムアウト制限がないことを示します。

デフォルト値は30です。

Windows ODBCデータソース・アドミニストレータ

「PL/SQL Timeout」フィールド

タイムアウト値の秒数を表す正の整数。
値0 (ゼロ)は、タイムアウト制限がないことを示します。

デフォルト値は30です。

関連項目

TTC_Timeout

TimesTen Cacheの初期接続属性

TimesTen Cacheの初期接続属性は、TimesTen Cache製品を使用している場合にのみ使用されます。この項では、表1-7「TimesTen Cacheの初期接続属性」に示したTimesTen Cacheの初期接続属性について説明します。

CacheAWTMethod

Oracle Databaseサーバーに変更を適用するための非同期ライトスルー伝播で、PL/SQL実行メソッドを使用するか、SQL配列実行メソッドを使用するかを決定します。

デフォルトでは、非同期ライトスルー(AWT)は、PL/SQL実行メソッド(CacheAWTMethod=1)を使用します。AWTでは、すべての保留中の処理を単一のPL/SQLコレクションにまとめ、Oracle Databaseサーバーに送信して実行します。このメソッドでは、混合トランザクションやTimesTenとOracle Databaseサーバー間にネットワーク遅延がある場合に、AWTのスループットを向上できます。

TimesTenでの変更をOracle Databaseに適用する際のSQL配列実行は、同じタイプの処理を繰り返す場合に適しています。たとえば、表の複数の行に影響する更新をユーザーが行う場合に配列実行は非常に効果的です。更新はグループにまとめられ、一度のバッチ処理でOracle Databaseサーバーに送信されます。

次のいずれかの場合に、PL/SQL実行メソッドは、ユーザーに意識させることなく一時的に配列実行モードになります。

- 長さが32761バイトを超える文。

- BINARY FLOAT、BINARY DOUBLEおよび4000バイトを超える長さのVARCHARの各データ型の列を参照する文。

AWTキャッシュ・グループにVARBINARY列が含まれる場合は、SQL実行メソッドCacheAWTMethod=0を指定します。

SYSTEMSTATS表には、実行メソッドが一時的にSQL配列実行モードになった回数に関する情報が含まれています。

注意:
アクティブ・スタンバイ・ペア・レプリケーション・スキームのすべてのTimesTenノードでは、同一のAWT実行メソッドを使用してください。

必要な権限

インスタンス管理者のみがこの属性の値を変更できます。

設定

CacheAWTMethodは次のように設定します。

属性の設定場所

属性の表示

設定

CまたはJavaプログラム、あるいはUNIX odbc.iniファイル

CacheAWTMethod

0: SQL配列実行メソッドを使用します。
1(デフォルト): PL/SQLコレクションおよび無名ブロックを使用します(PL/SQL実行メソッド)。

Windows ODBCデータソース・アドミニストレータ

「Cache AWT Method」フィールド

0: SQL配列実行メソッドを使用します。
1(デフォルト): PL/SQLコレクションおよび無名ブロックを使用します(PL/SQL実行メソッド)。

TimesTen Cacheのデータベース属性

TimesTen Cacheの接続属性は、TimesTen Cache製品を使用している場合にのみ使用されます。この項では、TimesTen Cacheのデータ・ストア属性について説明します。

CacheAWTParallelism

CacheAWTParallelismは、Oracle Databaseに変更を適用するスレッドの数を示します。この属性はReplicationParallelismおよびReplicationApplyOrderingと関連性があります。デフォルトは1です。

この属性を設定しない場合、またはデフォルトの1に設定した場合、Oracle Databaseに変更を適用するスレッドの数はReplicationParallelismに設定された数の2倍になります。CacheAWTParallelism属性が1に設定されているか設定されていない場合、ReplicationParallelismで許容される最大値は16です。

ReplicationParallelism属性とCacheAWTParallelism属性の両方が設定されている場合は、CacheAWTParallelismに設定される値がパラレル伝播で使用するスレッド数を構成します。CacheAWTParallelismの設定は、パラレル伝播の適用スレッド数を決定し、ReplicationParallelismの設定は、パラレル・レプリケーションのスレッド数を決定します。

パラレルAWTキャッシュの詳細は、『Oracle TimesTen Application-Tier Database Cacheユーザーズ・ガイド』のOracle Database表へのパラレル伝播の構成に関する説明を参照してください。

必要な権限

インスタンス管理者のみがこの属性の値を変更できます。

設定

CacheAWTParallelismは次のように設定します。

属性の設定場所

属性の表示

設定

CまたはJavaプログラム、あるいはUNIX odbc.iniファイル

CacheAWTParallelism

n: Oracle Databaseに変更を適用するスレッドの数を示す1から31の整数です。デフォルトは1です。

Windows ODBCデータソース・アドミニストレータ

「Cache AWT Parallelism」フィールド

n: Oracle Databaseに変更を適用するスレッドの数を示す1から31の整数です。デフォルトは1です。

CacheGridEnable

キャッシュ・グリッドを有効または無効にします。キャッシュ・グループを作成するには、TimesTenデータベースがキャッシュ・グリッドのメンバーである必要があります。デフォルトは1(有効)です。

必要な権限

インスタンス管理者のみがこの属性の値を変更できます。

設定

CacheGridEnableは次のように設定します。

属性の設定場所

属性の表示

設定

CまたはJavaプログラム、あるいはUNIX odbc.iniファイル

CacheGridEnable

0: キャッシュ・グリッドの外部でキャッシュ・グループを定義できます。
1(デフォルト): データベース内のすべてのキャッシュ・グループが、キャッシュ・グリッドのメンバーとして定義されている必要があります。

Windows ODBCデータソース・アドミニストレータ

「Cache Grid Enable」チェック・ボックス

選択解除: キャッシュ・グリッドの外部でキャッシュ・グループを定義できます。
選択(デフォルト): データベース内のすべてのキャッシュ・グループが、キャッシュ・グリッドのメンバーとして定義されている必要があります。

CacheGridMsgWait

キャッシュ・グリッド内のリモート・メンバーからのメッセージ・レスポンスを、アプリケーションが待機する秒数を指定します。

最大待機時間には、LockWait接続属性の値にこの属性の値を加えた値が含まれます。

TimesTenキャッシュ・グリッドのOracle Databaseからのデータのキャッシュの詳細は、『Oracle TimesTen Application-Tier Database Cacheユーザーズ・ガイド』を参照してください。

必要な権限

この属性の値の変更に権限は必要ありません。

設定

CacheGridMsgWaitは次のように設定します。

属性の設定場所

属性の表示

設定

CまたはJavaプログラム、あるいはUNIX odbc.iniファイル

CacheGridMsgWait

リモート・メンバーからのキャッシュ・グリッド・メッセージをTimesTenが待機する秒数を設定します。デフォルトは60です。

Windows ODBCデータソース・アドミニストレータ

「Cache Grid Message Wait」フィールド

リモート・メンバーからのキャッシュ・グリッド・メッセージをTimesTenが待機する秒数を設定します。デフォルトは60です。

TimesTen Cacheの一般接続属性

TimesTen Cacheの一般接続属性は、TimesTen Cache製品を使用している場合にのみ使用されます。この項では、表1-9「TimesTen Cacheの一般接続属性」に示したTimesTen Cacheの一般接続属性について説明します。

DynamicLoadEnable

この属性は、Oracle DatabaseからTimesTenの動的キャッシュ・グループへのデータの動的ロードを有効または無効にします。デフォルトでは、Oracle Databaseからのデータの動的ロードが有効になっています。

文レベルで動的ロードを有効または無効にして一時的にこの属性の設定を上書きするには、DynamicLoadEnableオプティマイザ・フラグをttOptSetFlag組込みプロシージャで設定するか、SQL文で文レベル・オプティマイザ・ヒントTT_DynamicLoadEnableを使用して設定します。

注意:
この属性の値は、データベースへの現在の接続での、すべての動的キャッシュ・グループの動的ロード動作を上書きします。

必要な権限

この属性の値の変更に権限は必要ありません。

設定

DynamicLoadEnableは次のように設定します。

属性の設定場所

属性の表示

設定

CまたはJavaプログラム、あるいはUNIX odbc.iniファイル

DynamicLoadEnable

0: 現在の接続について、Oracle DatabaseからTimesTenの動的キャッシュ・グループへのデータの動的ロードを無効にします。
1(デフォルト): 現在の接続について、Oracle DatabaseからTimesTenの動的キャッシュ・グループへのデータの動的ロードを有効にします。

Windows ODBCデータソース・アドミニストレータ

「Dynamic Load Enable」フィールド

0: 現在の接続について、Oracle DatabaseからTimesTenの動的キャッシュ・グループへのデータの動的ロードを無効にします。
1(デフォルト): 現在の接続について、Oracle DatabaseからTimesTenの動的キャッシュ・グループへのデータの動的ロードを有効にします。

DynamicLoadErrorMode

この属性は、アプリケーションが動的キャッシュ・グループに対してSQL処理を実行する場合およびSQL処理で動的ロードが使用できない場合の動作を制御します。

値0を設定すると、TimesTenキャッシュ表にあるどんなデータに対してもSQL処理が実行され、エラーを表示することなく、データに基づいた結果が返されます。

値1を設定すると、(動的ロードが必要でない場合でも)動的ロードを使用できないすべての文は、動的ロードに対応していないというエラーを表示して、処理が失敗します。

TimesTenキャッシュ・グループのOracle Databaseからのデータのキャッシュの詳細は、『Oracle TimesTen Application-Tier Database Cacheユーザーズ・ガイド』を参照してください。

注意:
文レベルでこの属性の値を上書きするには、DynamicLoadErrorModeオプティマイザ・フラグをttOptSetFlag組込みプロシージャで設定するか、SQL文で文レベル・オプティマイザ・ヒントTT_DynamicLoadErrorModeを使用して設定します。
詳細は、『Oracle TimesTen In-Memory Database SQLリファレンス・ガイド』の文レベル・オプティマイザ・ヒントに関する説明を参照してください。

必要な権限

この属性の値の変更に権限は必要ありません。

設定

DynamicLoadErrorModeは次のように設定します。

属性の設定場所

属性の表示

設定

CまたはJavaプログラム、あるいはUNIX odbc.iniファイル

DynamicLoadErrorMode

0(デフォルト): 文は、キャッシュされているデータに対して、エラーを発生せずに処理を実行します。
1: 文は動的ロードを使用するか、エラーを表示して失敗します。

Windows ODBCデータソース・アドミニストレータ

「DynamicLoadErrorMode」フィールド

0(デフォルト): 文は、キャッシュされているデータに対して、エラーを発生せずに処理を実行します。
1: 文は動的ロードを使用するか、エラーを表示して失敗します。

OracleNetServiceName

TimesTen Cacheでは、OracleNetServiceName属性が使用されます。

この属性では、Oracleインスタンスのサービス名が識別されます。

Oracle Database表をキャッシュし、Oracle Databaseとの通信を有効にするには、Oracleサービス名を指定する必要があります。

必要な権限

この属性の値の変更に権限は必要ありません。

設定

OracleNetServiceNameは次のように設定します。

属性の設定場所

属性の表示

設定

CまたはJavaプログラム、あるいはUNIX odbc.iniファイル

OracleNetServiceName

Oracle IDとして使用されるOracleサービス名を指定する文字列です。

Windows ODBCデータソース・アドミニストレータ

「OracleNetServiceName」フィールド

Oracle IDとして使用されるOracleサービス名を指定する文字列です。

OraclePWD

TimesTen Cacheでは、OraclePWD属性が使用されます。

この属性の値はOracle Databaseに接続してキャッシュ処理を実行するための、UIDで指定されるユーザーのパスワードです。

必要な権限

この属性の値の設定に権限は必要ありません。

設定

この属性は接続文字列で設定する必要があります。Linuxで、次のようにodbc.iniファイルを定義したとします。

[myDSN]
Datastore=/data/myDSN
PermSize=128
DatabaseCharacterSet=AL32UTF8
ConnectionCharacterSet=AL32UTF8

myDSNに接続することでユーザーttuserのOraclePWDを設定するには、次のように指定します。

% ttisql

Copyright (c) 1996-2011, Oracle.  All rights reserved.
Type ? or "help" for help, type "exit" to quit ttIsql.

Command> connect "dsn=myDSN;OraclePWD=mypwd";
Connection successful:
DSN=beta4;UID=ttuser;DataStore=/data/myDSN;DatabaseCharacterSet=AL32UTF8;
ConnectionCharacterSet=AL32UTF8;PermSize=128;TypeMode=0;
(Default setting AutoCommit=1)
Command>

Windowsでは、Linuxでの設定と同じ方法で接続文字列にOraclePWDを設定します。

関連項目

UIDおよびPWD

PassThrough

TimesTen Cacheでは、PassThrough属性が使用されます。

これは、キャッシュ・データベースでのみ実行されるSQL文、およびOracle Databaseに渡されるSQL文を指定します。TimesTen Cacheの詳細は、『Oracle TimesTen Application-Tier Database Cacheユーザーズ・ガイド』、および『Oracle TimesTen In-Memory Database SQLリファレンス』のCREATE CACHE GROUPに関する説明を参照してください。

準備されたPassThroughコマンドを実行する場合、Oracle Databaseの依存オブジェクトのスキーマが準備後に変更されていないと想定しています。スキーマが変更されている場合は、PassThroughコマンドによってOracle Databaseで予期せぬ結果が発生する可能性があります。

SQL文をOracle Databaseに渡す場合、TimesTenでサポートされるデータ型のみを列定義で使用してください。指定されたデータ型がTimesTenでサポートされていない場合、パススルー文は失敗します。

この属性を使用したOracle Database接続時の分離レベルの変更については、「Isolation」を参照してください。

必要な権限

この属性の値の変更に権限は必要ありません。

設定

PassThroughは次のように設定します。

属性の設定場所

属性の表示

設定

CまたはJavaプログラム、あるいはUNIX odbc.iniファイル

PassThrough

0(デフォルト): SQL文はTimesTenに対してのみ実行されます。
1: TimesTen以外の1つ以上の表を参照していないかぎり、INSERT、UPDATEおよびDELETE文はTimesTenに対して実行されます。TimesTen以外の1つ以上の表を参照している場合は、Oracle Databaseに渡されます。DDL文はTimesTenに対して実行されます。その他の文がTimesTenで構文エラーを生成する場合、またはその他の文で参照されている1つ以上の表がTimesTenに存在しない場合に、その他の文はOracle Databaseに渡されます。

2: 読取り専用キャッシュ・グループまたはREADONLYキャッシュ表属性を持つユーザー管理キャッシュ・グループ表に対して実行されたINSERT、UPDATEおよびDELETE文は、Oracle Databaseに渡されます。その他のキャッシュ・グループ・タイプに対するパススルー動作は、PassThrough=1と同じです。

3: TimesTenエラーとなる動的AWTグローバル・キャッシュ・グループのキャッシュ表に対して実行されるINSERT、UPDATEおよびDELETE文を除いて、すべての文はOracle Databaseに渡されて実行されます。

4: 動的ロードの問合せの基準を満たさない動的AWTグローバル・キャッシュ・グループのキャッシュ表に対して実行されたSELECT文は、Oracle Databaseに渡されて実行されます。これ以外の場合、文はTimesTenデータベースで実行されます。

5: 接続中の以前のトランザクションによって、動的AWTグローバル・キャッシュ・グループのキャッシュ表でコミットされたすべての更新がOracle Databaseに伝播されるときに、動的ロード問合せの基準を満たさない動的AWTグローバル・キャッシュ・グループのキャッシュ表に対して実行されたSELECT文はOracle Databaseに渡されて実行されます。これ以外の場合、文はTimesTenデータベースで実行されます。

Windows ODBCデータソース・アドミニストレータ

「PassThrough」リスト

0(デフォルト): SQL文はTimesTenに対してのみ実行されます。
1: TimesTen以外の1つ以上の表を参照していないかぎり、INSERT、UPDATEおよびDELETE文はTimesTenに対して実行されます。TimesTen以外の1つ以上の表を参照している場合は、Oracle Databaseに渡されます。DDL文はTimesTenに対して実行されます。その他の文がTimesTenで構文エラーを生成する場合、またはその他の文で参照されている1つ以上の表がTimesTenに存在しない場合に、その他の文はOracle Databaseに渡されます。

2: 読取り専用キャッシュ・グループまたはREADONLYキャッシュ表属性を持つユーザー管理キャッシュ・グループ表に対して実行されたINSERT、UPDATEおよびDELETE文は、Oracle Databaseに渡されます。その他のキャッシュ・グループ・タイプに対するパススルー動作は、PassThrough=1と同じです。

3: TimesTenエラーとなる動的AWTグローバル・キャッシュ・グループのキャッシュ表に対して実行されるINSERT、UPDATEおよびDELETE文を除いて、すべての文はOracle Databaseに渡されて実行されます。

4: 動的ロードの問合せの基準を満たさない動的AWTグローバル・キャッシュ・グループのキャッシュ表に対して実行されたSELECT文は、Oracle Databaseに渡されて実行されます。これ以外の場合、文はTimesTenデータベースで実行されます。

5: 接続中の以前のトランザクションによって、動的AWTグローバル・キャッシュ・グループのキャッシュ表でコミットされたすべての更新がOracle Databaseに伝播されるときに、動的ロード問合せの基準を満たさない動的AWTグローバル・キャッシュ・グループのキャッシュ表に対して実行されたSELECT文はOracle Databaseに渡されて実行されます。これ以外の場合、文はTimesTenデータベースで実行されます。

Restrictions

PassThrough機能を使用する場合、いくつかの制限を考慮する必要があります。次の制限があります。

- 問合せがOracle Databaseで実行される必要があるようにPassThrough属性が設定されている場合は、その問合せは変更されずにOracle Databaseに送信されます。問合せがキャッシュ・グループの表に対してシノニムを使用する場合、問合せが成功するためには、同じ名前のシノニムが対応するOracle Database表に定義されている必要があります。

- TimesTen独自の構文を使用するSQL文がOracle Databaseに渡される場合、TimesTenはその構文がOracle Databaseでサポートされていないことを示すエラー・メッセージを返します。

- 準備されたPassThroughコマンドを実行する場合、Oracle Databaseの依存オブジェクトのスキーマが準備後に変更されていないと想定しています。スキーマが変更されている場合は、予期せぬ結果が発生する可能性があります。

- TimesTenはキャッシュを無効にする機能を備えていません。TimesTenはキャッシュされた表が最新の状態であるかを検証しません。TimesTenで問合せの構文が正しく、問合せで参照されるすべての表がキャッシュに存在する場合、キャッシュが最新であるかどうかにかかわらず問合せはTimesTenで実行されます。

- OracleのINSERT、UPDATEまたはDELETE処理のパススルーは、前述の表で説明するPassThrough属性の設定によって異なります。TimesTen Cacheは、トリガーやストアド・プロシージャの中に隠されたINSERT、UPDATEおよびDELETE処理を検出できません。このため、TimesTenは隠された処理に対してPassThroughルールを適用できません。

- PL/SQLブロックをOracle Databaseに渡すことはできません。

- 読取り専用キャッシュ・グループに対するパススルーのINSERT、UPDATEまたはDELETE処理の結果は、トランザクションがコミットされた後、および次の自動リフレッシュ処理が完了した後にのみ反映されます。

- TimesTenの同期ライトスルー・キャッシュ・グループにキャッシュされるOracle Database表に対する更新を検出またはブロックするメカニズムはありません。更新がキャッシュ経由で渡された文によって実行されたものであるか、その他のOracle Databaseアプリケーションからのものであるかにかかわらず、変更内容はTimesTen Cacheには反映されません。

- Oracle Call Interface(OCI)では、入力パラメータのバインド型を表すメカニズムがサポートされていません。アプリケーションでPassThrough文に正しいSQLのデータ型が指定されているかを確認してください。ODBCドライバにより、CおよびSQLのデータ型がTimesTenに変換され、変換後のデータとSQLのデータ型のコードが表示されます。TimesTenはその情報をOCIに示します。LONG型およびLONG RAW型の入力バインド値の長さは4000に制限されます。

- すべてのパススルー・レベルにおいて、DDL文のパススルーの実行はTimesTen側ではコミットされません。

- RETURN TWOSAFEを使用してレプリケートされる処理を含むトランザクションでは、PassThroughに0より大きい値を設定できません。PassThroughに0よりも大きい値が指定されている場合は、エラーが返され、トランザクションをロールバックする必要があります。

- PassThroughを0、1、または2に設定した場合、動的ロード条件が存在するときには次の動作が発生します。

- 動的ロードは、すべての動的キャッシュ・グループ・タイプのキャッシュ表に対するSELECT操作で発生可能です。

- INSERT操作、UPDATE操作またはDELETE操作に対する動的ロードは、動的非同期ライトスルーまたは動的同期ライトスルー・キャッシュ・グループのキャッシュされた表に対してのみ実行できます。

INSERT文、UPDATE文、DELETE文およびSELECT文の詳細は、『Oracle TimesTen In-Memory Database SQLリファレンス』の「SQL文」を参照してください。

RACCallback

この属性は、TimesTen CacheでOracle Real Application Clusters (Oracle RAC)を使用するときに、透過的アプリケーション・フェイルオーバー(TAF)および高速アプリケーション通知(FAN)のコールバックのインストールを有効にするかどうかを指定します。

TimesTen Cacheの詳細は、『Oracle TimesTen Application-Tier Database Cacheユーザーズ・ガイド』、および『Oracle TimesTen In-Memory Database SQLリファレンス』のCREATE CACHE GROUPに関する説明を参照してください。

必要な権限

この属性の値の変更に権限は必要ありません。

設定

RACCallbackは次のように設定します。

属性の設定場所

属性の表示

設定

CまたはJavaプログラム、あるいはUNIX odbc.iniファイル

RACCallback

0: TAFおよびFANコールバックをインストールしません。
1(デフォルト): TAFおよびFANコールバックをインストールします。

Windows ODBCデータソース・アドミニストレータ

「RACCallback」チェック・ボックス

選択解除: TAFおよびFANコールバックをインストールしません。
選択(デフォルト): TAFおよびFANコールバックをインストールします。

TimesTen Client接続属性

TimesTen Client接続属性は、TimesTenクライアント・アプリケーションからTimesTenサーバーに接続する場合にのみ使用されます。この項では、表1-10「TimesTen Client接続属性」に示したTimesTen Clientの接続属性について説明します。

この項に示した属性の他にも、クライアント接続に使用可能で、接続の動作に影響を与えるデータベース属性や一般接続属性があります。これらの属性は次のとおりです。

- ConnectionCharacterSet

- ConnectionName

- UIDおよびPWD

クライアント属性の値を表示するには、ODBC関数のSQLGetConnectOptionを使用します。この関数の詳細は、『Oracle TimesTen In-Memory Database C開発者ガイド』のSQLSetConnectOptionおよびSQLGetConnectOptionのオプションのサポートに関する説明を参照してください。

TCP_Port

TimesTen ClientおよびServerを使用してTimesTenデータベースに接続する場合、TimesTen ClientにはTimesTen Serverを実行しているコンピュータのネットワーク・アドレスとTCPポート番号が必要です。設定を容易にするために、TimesTenではネットワーク・アドレスとポート番号の組合せを含む論理サーバー名を定義できます。

クライアントのDSN定義のTTC_Server属性に論理サーバー名以外を設定した場合、TimesTen ClientはサーバーがデフォルトのTCP/IPポート番号を使用していると想定します。この場合、サーバーがデフォルト以外のポートを使用していると、ODBC接続文字列にポート番号を指定する必要があります。次に例を示します。

"TTC_SERVER=server_host_name;
TTC_SERVER_DSN=Server_DSN;TCP_PORT=server_port"

または

"DSN=Client_DSN;TCP_Port=server_port"

必要な権限

この属性の値の変更に権限は必要ありません。

設定

TCP_Portは次のように設定します。

属性の設定場所

属性の表示

設定

CまたはJavaプログラム

TCP_Port

サーバーがリスニングするポート番号を指定します。

Windows ODBCデータソース・アドミニストレータおよびUNIX odbc.iniファイル

TimesTenでは、この属性をUNIX odbc.iniファイルまたはWindows ODBCデータソース・アドミニストレータに直接指定することはできません。かわりに、TCP_Portを論理サーバー名に定義することができます。

N/A

TCP_Port2

TimesTenではこの属性を使用して、自動フェイルオーバーが発生したときに使用するポート番号を指定します。この属性および関連する属性の値の設定については、TCP_Portの説明を参照してください。

自動クライアント・フェイルオーバーの詳細は、『Oracle TimesTen In-Memory Databaseオペレーション・ガイド』を参照してください。

必要な権限

この属性の値の変更に権限は必要ありません。

設定

TCP_Port2は次のように設定します。

属性の設定場所

属性の表示

設定

CまたはJavaプログラム

TCP_Port2

サーバーがリスニングするフェイルオーバー・ポート番号を指定します。

Windows ODBCデータソース・アドミニストレータおよびUNIX odbc.iniファイル

TimesTenでは、この属性をUNIX odbc.iniファイルまたはWindows ODBCデータソース・アドミニストレータに直接指定することはできません。かわりに、TCP_Portを論理サーバー名に定義することができます。

N/A

TTC_FailoverPortRange

アクティブ/スタンバイ・レプリケーション構成で、自動クライアント・フェイルオーバー・スレッドがフェイルオーバー通知をリスニングするポートのポート範囲を指定します。フェイルオーバー構成では、現在のノードで障害が発生した場合、クライアント・アプリケーションは新しいアクティブ・ノードに自動的に接続できます。

ポート範囲を指定すると、クライアント・システムとサーバー・システムの間のファイアウォールに対応できます。デフォルトでは、TimesTenはオペレーティング・システムで選択されたポートを使用します。

注意:
クライアント・フェイルオーバーは、クライアントがアクティブ・スタンバイ・ペアのレプリケーション構成の一部である場合にのみサポートされます。

自動クライアント・フェイルオーバーの詳細は、『Oracle TimesTen In-Memory Databaseオペレーション・ガイド』を参照してください。

必要な権限

この属性の値の変更に権限は必要ありません。

設定

TTC_FailoverPortRangeは次のように設定します。

属性の設定場所

属性の表示

設定

CまたはJavaプログラム、あるいはUNIX odbc.iniファイル

TTC_FailoverPortRange

ポート番号の下位値および上位値をlowervalue—uppervalueの形式で指定します。

Windows ODBCデータソース・アドミニストレータ

「Failover Port Range」フィールド

ポート番号の下位値および上位値をlowervalue—uppervalueの形式で指定します。

TTC_Server

TimesTen ClientおよびServerを使用してTimesTenデータベースに接続する場合、TimesTen ClientにはTimesTen Serverを実行しているコンピュータのネットワーク・アドレスとTCPポート番号の指定が必要です。設定を容易にするために、TimesTenではネットワーク・アドレスとポート番号の組合せを含む論理サーバー名を定義できます。この属性に論理サーバー名以外を指定した場合、TimesTen ClientはサーバーがデフォルトのTCP/IPポート番号を使用していると想定します。この場合、サーバーがデフォルト以外のポートを使用していると、ODBC接続文字列にポート番号を指定する必要があります。次に例を示します。

"TTC_SERVER=server_host_name;
TTC_SERVER_DSN=Server_DSN;TCP_PORT=server_port"

または

"DSN=Client_DSN;TCP_Port=server_port"

論理サーバー名は一旦定義されると、その名前をクライアントDSNでTTC_Server属性の値として使用できます。複数のクライアントDSNがTimesTen Serverを実行している同じコンピュータを参照する場合、それぞれのクライアントDSNで同じネットワーク・アドレスおよびポート番号を繰り返し指定するかわりに、TTC_Server属性の値として同じ論理サーバー名を使用できます。

注意:
TimesTenではTTC_Server属性に論理サーバー名を指定することをお薦めします。ただし、TTC_Server属性にドメイン名サーバー(DNS)、ホスト名またはIPアドレスを指定することもできます。論理サーバー名を使用せずに、TimesTen Serverがデフォルト以外のポート番号をリスニングする場合は、ODBC接続文字列にそのポート番号を指定する必要があります。次に例を示します。

"TTC_SERVER=server_host_name;TTC_SERVER_DSN=Server_DSN;
TCP_PORT=server_port"

または

"DSN=Client_DSN;TCP_Port=server_port"

必要な権限

この属性の値の変更に権限は必要ありません。

設定

TTC_Serverは次のように設定します。

属性の設定場所

属性の表示

設定

CまたはJavaプログラム、あるいはUNIX odbc.iniファイル

TTC_Server

論理サーバーを指定する文字列です。

Windows ODBCデータソース・アドミニストレータ

「Server Name」または「Network Address」フィールド

論理サーバーを指定する文字列です。

TTC_Server2

この属性は、自動フェイルオーバーが発生したときに使用する論理サーバー名を指定します。この属性および関連する属性の値設定の詳細は、TTC_Serverの説明を参照してください。

この属性は、TTC_Serverが仮想IPアドレスの場合、TTC_Serverに指定された値と同じ値にすることができます。

クライアントがすでにフェイルオーバーしてTTC_Server2に接続されている場合、その接続が失敗すると、クライアントはTTC_Serverに接続します。クライアントは、TTC_TIMEOUT属性が期限切れとなるまで、TTC_ServerとTTC_Server2に交互に接続を試みます。

注意:
クライアント・フェイルオーバーは、クライアントがアクティブ・スタンバイ・ペアのレプリケーション構成の一部である場合にのみサポートされます。

自動クライアント・フェイルオーバーの詳細は、『Oracle TimesTen In-Memory Databaseオペレーション・ガイド』を参照してください。

必要な権限

この属性の値の変更に権限は必要ありません。

設定

TTC_Server2は次のように設定します。

属性の設定場所

属性の表示

設定

CまたはJavaプログラム、あるいはUNIX odbc.iniファイル

TTC_Server2

自動フェイルオーバーが発生したときに使用される論理サーバーを指定する文字列です。

Windows ODBCデータソース・アドミニストレータ

「Server Name」または「Network Address2」フィールド

自動フェイルオーバーが発生したときに使用される論理サーバーを指定する文字列です。

TTC_Server_DSN

TTC_Server_DSN属性は、TimesTen Serverを実行しているコンピュータのサーバーDSNを指定します。

Windowsでは、サーバーDSNはTimesTen Data Managerドライバを使用する、一連のTimesTenシステムDSNです。ODBCデータソース・アドミニストレータを使用して、サーバーDSNを定義します。

UNIXでは、サーバーDSNは/var/TimesTen/instance/sys.odbc.iniファイルに定義されています。詳細は、ご使用のプラットフォームに関する説明を参照してください。

必要な権限

この属性の値の変更に権限は必要ありません。

設定

TTC_Server_DSNは次のように設定します。

属性の設定場所

属性の表示

設定

CまたはJavaプログラム、あるいはUNIX odbc.iniファイル

TTC_Server_DSN

サーバー上に存在するDSNを指定する文字列です。

Windows ODBCデータソース・アドミニストレータ

「Server DSN」フィールド

サーバー上に存在するDSNを指定する文字列です。

TTC_Server_DSN2

この属性は、TimesTen Serverを実行しているコンピュータのサーバーDSNを指定します。自動フェイルオーバーが発生したときに使用されるサーバーDSNです。この属性および関連する属性の値設定の詳細は、TTC_Server_DSNの説明を参照してください。

フェイルオーバーが発生した場合、クライアントがTTC_Server_DSNに接続できないか、またはDSNへの接続が失われると、クライアントはTTC_Server_DSN2への接続を試みます。

注意:
クライアント・フェイルオーバーは、クライアントがアクティブ・スタンバイ・ペアのレプリケーション構成の一部である場合にのみサポートされます。

自動クライアント・フェイルオーバーの詳細は、『Oracle TimesTen In-Memory Databaseオペレーション・ガイド』を参照してください。

必要な権限

この属性の値の変更に権限は必要ありません。

設定

TTC_Server_DSN2は次のように設定します。

属性の設定場所

属性の表示

設定

CまたはJavaプログラム、あるいはUNIX ODBC.INIファイル

TTC_Server_DSN2

自動フェイルオーバーが発生したときに使用される、サーバー上に存在するDSNを指定する文字列です。

Windows ODBCデータソース・アドミニストレータ

「Server DSN2」フィールド

自動フェイルオーバーが発生したときに使用される、サーバー上に存在するDSNを指定する文字列です。

TTC_Timeout

TTC_Timeout属性は、TimesTen ClientおよびServerの使用によって完了するネットワーク処理に対して、最大時間制限を秒単位で設定します。また、TTC_Timeout属性では、タイムアウトする前にTimesTen Clientアプリケーションがそれに対応するTimesTen Serverプロセスの結果を待機する最大の秒数も指定します。

クライアント/サーバー接続のクライアント側でのオペレーティング・システムselect()コールでは、TTC_TIMEOUTの値が使用されます。SQLExecute()およびOCIStmtExecute()関数では、この属性の値は使用されません。

0の値はクライアント/サーバー処理がタイムアウトしないことを示します。この属性の設定はオプションです。この属性を設定しない場合、デフォルトのタイムアウト時間は60秒です。最大のタイムアウト時間は99,999秒です。タイムアウト時には処理が中断され、クライアント・アプリケーションはタイムアウト・エラーを受信し、接続が切断されます。たとえば、クライアント・アプリケーションが長い問合せを実行する場合には、タイムアウト時間を増やすことができます。

アクティブ・スタンバイ・ペアのフェイルオーバー・シナリオの場合、最小値は60秒です。

PL/SQLを使用している場合は、PLSQL_TIMEOUTの値をTTC_TIMEOUTマイナス5秒以下に設定してください。.

問合せのタイムアウトは、SQLConnectまたはSQLDriverConnect ODBCコールのいずれかを使用してデータベースへの接続が確立される前にSQLSetConnectOption ODBCコールを使用して設定できます。あるいは、データベースへの接続が確立された後にSQLSetConnectOptionまたはSQLSetStmtOption ODBCコールのいずれかをコールすることによって設定できます。

データベースに接続を確立する前に問合せのタイムアウトが設定された場合、その時点ではクライアント・ドライバではネットワークのタイムアウト値が認識されません。このため、次のような場合、接続時に、クライアント・ドライバでは問合せのタイムアウトがネットワークのタイムアウトの値よりもわずかに小さい値に自動的に設定されます。

- ネットワークのタイムアウト値が0よりも大きい場合。

- 問合せのタイムアウト値が0またはネットワークのタイムアウト値以上である場合。

タイムアウト値は、接続が確立された後にttIsql clienttimeoutコマンドをコールすることによって設定できます。データベースへの接続を確立した後で問合せのタイムアウトが設定された場合、ネットワークのタイムアウト値が0よりも大きく、問合せのタイムアウト値がネットワークのタイムアウト値以上であるとき、クライアント・ドライバはエラーを返します。SQLStateはS1000に設定されます。

クライアント/サーバーのプロセス間通信に共有メモリーが使用されている場合、この属性はサポートされません。この属性を設定しても無視されます。

必要な権限

この属性の値の変更に権限は必要ありません。

設定

TTC_Timeoutは次のように設定します。

属性の設定場所

属性の表示

設定

CまたはJavaプログラム、あるいはUNIX ODBC.INIファイル

TTC_Timeout

タイムアウト前にTimesTen Clientが接続を待機する秒数を表す、0から99999までの値です。(デフォルト値は60です。)アクティブ・スタンバイ・ペアのフェイルオーバー・シナリオでの最小値は60です。

Windows ODBCデータソース・アドミニストレータ

「Timeout Interval」フィールド

タイムアウト前にTimesTen Clientが接続を待機する秒数を表す、0から99999までの値です。(デフォルト値は60です。)アクティブ・スタンバイ・ペアのフェイルオーバー・シナリオでの最小値は60です。

サーバー接続属性

サーバー接続属性は、サーバーDSNのみで指定され、初期接続時に読み取られます。『Oracle TimesTen In-Memory Databaseオペレーション・ガイド』のTimesTen ServerシステムでのサーバーDSNの定義に関する説明を参照してください。これらの属性を使用して、TimesTenサーバーへの接続数、各DSNに対するサーバー数およびサーバーへのそれぞれの接続のサイズを設定します。これらの属性を使用すると、1つのサーバーに対して複数のクライアント接続を指定できます。デフォルトでは、TimesTenは、1つのサーバーに対する接続を子プロセスごとに1つのみ作成します。

注意:
これらの属性はDSNで指定する必要があります。接続文字列で指定しても、属性とその値は無視されます。

複数のサーバー接続を指定できるTimesTenメイン・デーモン・オプションもあります。デーモン・オプションとこれらの属性の両方が指定されている場合、属性の値が優先されます。

この項では、表1-11「TimesTen Server接続属性」に示したサーバー接続属性について説明します。

MaxConnsPerServer

MaxConnsPerServer属性は、DSNが参照するサーバーへの最大同時接続数を設定します。

サーバーへの多くの接続をサポートするには、TimesTenを実行しているUIDのプロセス当たりのファイル記述子制限に、アクティブな同時子サーバー数を多少超える値を設定する必要があります。これは、予測される同時クライアント接続数をMaxConnsPerServerで割った値です。

この属性の値は、ttendaemon.optionsファイルの-maxConnsPerServerオプションの設定より優先されます。詳細は、『Oracle TimesTen In-Memory Databaseオペレーション・ガイド』のTimesTen Serverに対する複数の接続の指定に関する説明を参照してください。

TimesTenデータベースへの最大接続数に対するシステム制限の詳細は、第4章「システム制限」を参照してください。

必要な権限

この属性の値を現在有効な値以外に変更できるのは、この属性が定義されているシステムDSNでオペレーティング・システム権限を持つユーザーのみです。

設定

MaxConnsPerServerは次のように設定します。

属性の設定場所

属性の表示

設定

CまたはJavaプログラム、あるいはUNIX odbc.iniファイル

MaxConnsPerServer

1から2047までの値になります。デフォルトは1です。

Windows ODBCデータソース・アドミニストレータ

「Maximum Connections Per Server Process」フィールド

1から2047までの値になります。デフォルトは1です。

ServersPerDSN

ServersPerDSN属性は、ラウンドロビン接続分散を使用する特定のサーバーDSNに対する子サーバー・プロセスの数を指定します。この属性は、TimesTenサーバーがマルチスレッド・モード(MaxConnsPerServer 1)で動作するように構成されている場合にのみ効果があります。ServersPerDSNが1に設定された場合、サーバーDSNへの最初のMaxConnsPerServerクライアント接続は1つの子サーバー・プロセスに割り当てられ、次のMaxConnsPerServer接続は2つ目の子サーバー・プロセスに割り当てられるといったようになります。ServersPerDSNがN(N 1)に設定された場合、サーバーDSNへの最初のN * MaxConnsPerServerクライアント接続は、N個の子サーバー・プロセスにラウンドロビン方式で分散されます。N * MaxConnsPerServerを超える追加のクライアント接続が同じサーバーDSNに対して開かれている場合、それらの接続はServersPerDSN=1の場合のように新しい子サーバー・プロセスに順次割り当てられます。この属性がサーバーDSN定義において設定される場合、そのサーバーDSNのためだけに、-serversPerDSNデーモン・オプション(ttendaemon.optionsファイルで指定)に指定された任意の値を優先します。-serversPerDSNおよびServersPerDSNのいずれも設定されない場合は、TimesTenではデフォルト値1が使用されます。詳細は、『Oracle TimesTen In-Memory Databaseオペレーション・ガイド』のTimesTen Serverに対する複数の接続の指定に関する説明を参照してください。

必要な権限

この属性の値を現在有効な値以外に変更できるのは、この属性が定義されているシステムDSNでオペレーティング・システム権限を持つユーザーのみです。

設定

ServersPerDSNは次のように設定します。

属性の設定場所

属性の表示

設定

CまたはJavaプログラム、あるいはUNIX odbc.iniファイル

ServersPerDSN

1から2047までの値になります。デフォルトは1です。

Windows ODBCデータソース・アドミニストレータ

「Server Processes Per DSN」フィールド

1から2047までの値になります。デフォルトは1です。

ServerStackSize

ServerStackSize属性の値は、サーバーでの各接続のスタック・サイズを決定します。この属性の値は、MaxConnsPerServerの値が1よりも大きい場合にのみ意味を持ちます。サーバーごとの接続が1つのみである場合、子サーバーはプロセスのメイン・スタックを使用します。これは、またプラットフォームに依存せず、次の設定で定義されます。

この属性の値は、ttendaemon.optionsファイルの-serverStackSizeオプションの設定より優先されます。詳細は、『Oracle TimesTen In-Memory Databaseオペレーション・ガイド』のTimesTen Serverに対する複数の接続の指定に関する説明を参照してください。

TimesTen Serverを再起動するまで、TimesTen Serverの設定変更は有効になりません。サーバーを再起動するには、ttDaemonAdmin -restartserverコマンドを使用します。

必要な権限

この属性の値を現在有効な値以外に変更できるのは、この属性が定義されているシステムDSNでオペレーティング・システム権限を持つユーザーのみです。

設定

ServerStackSizeは次のように設定します。

属性の設定場所

属性の表示

設定

CまたはJavaプログラム、あるいはUNIX odbc.iniファイル

ServerStackSize

有効な値はプラットフォームに依存します。デフォルトは、32-bitプラットフォームの場合は128KB、64-bitプラットフォームの場合は256KBです。
sysconfコールを使用できる場合、最小値は次のとおりです。

sysconf(_SC_THREAD_STACK_MIN)/ 1024

その他の場合、最小値は0です。

通常、serverstackのサイズを設定する必要はありません。ただし、ttcserverが繰返しコア・ダンプする場合、serverstacksizeを増やすことを考慮する必要があります。

Windows ODBCデータソース・アドミニストレータ

「Server Stack Size」フィールド

有効な値はプラットフォームに依存します。デフォルトは、32-bitプラットフォームの場合は128KB、64-bitプラットフォームの場合は256KBです。
通常、serverstackのサイズを設定する必要はありません。ただし、ttcserverが繰返しアクセス違反する場合は、serverstacksizeを増やすことを考慮する必要があります。

2 組込みプロシージャ

TimesTen組込みプロシージャによって、標準のODBCおよびJDBC機能が拡張されます。これらのプロシージャは、ODBCまたはJDBCのプロシージャ・コール・インタフェースを使用してコールできます。プロシージャは、次の例に示すとおり、SQL文と同様に実行されます。

次のODBCのSQLExecDirectコールはttOpsSetFlag組込みプロシージャを起動し、オプティマイザに対して、コマンドを準備するときに一時ハッシュ索引を作成しないように指示します。

SQLExecDirect (hstmt, (SQLCHAR*)
"{CALL ttOptSetFlag ('TmpHash', 0)}", SQL_NTS);

このコールは、次のJDBCコールと同等です。

CallableStatement cstmt = con.prepareCall
("{CALL ttOptSetFlag ('TmpHash', 0)}");
cstmt.execute();

TimesTen組込みプロシージャは、次の例に示すとおり、CALLとともにEXECUTE IMMEDIATE文を使用してPL/SQLからコールすることもできます。この文の詳細は、『Oracle TimesTen In-Memory Database PL/SQL開発者ガイド』を参照してください。

たとえば、組込みプロシージャttConfigurationをコールするには、PL/SQLレコード型を作成した後、SELECT INTOを実行してそのレコード型に値を入れます。ttConfigurationでは複数の行が返されるため、BULK COLLECTを使用します。

Command> DECLARE
>   TYPE ttConfig_record IS RECORD
>      (name varchar2(255), value varchar2 (255));
>   TYPE ttConfig_table IS TABLE OF ttConfig_record;
> v_ttConfigs ttConfig_table;
> BEGIN
>  EXECUTE IMMEDIATE  'CALL ttConfiguration'
>   BULK COLLECT into v_ttConfigs;
>  DBMS_OUTPUT.PUT_LINE ('Name: ' || v_ttConfigs(1).name
>    || ' Value: ' || v_ttConfigs(1).value);
> end;
> /
Name: CacheGridEnable Value: 0

PL/SQL procedure successfully completed.

注意:
組込みプロシージャの文字列パラメータ値は、値がNULLである場合を除き、この例で示すように一重引用符で囲む必要があります。

ttAgingLRUConfig

説明

このプロシージャは、Least Recently Used(LRU)エージング・ポリシーを指定して定義されたすべての通常の表にLRUエージング属性を設定します。キャッシュ表の場合、エージング・ポリシーはルート表に定義されますが、キャッシュ・グループのすべての表に適用されます。エージング・ポリシーは、CREATE TABLEまたはALTER TABLE SQL文を使用して、エージング・ポリシーが作成または変更されるときに表に定義されます。

LRUエージング機能を使用すると、使用頻度が最も少ないデータを削除して、指定したしきい値以下にデータベースの使用サイズを保持できます。

使用中のデータベース領域が指定されているしきい値を超えると、データが削除されます。キャッシュ・グループの場合、エージングはキャッシュ・インスタンス全体のルート表で定義されます。AUTOREFRESH属性が指定されていると、キャッシュ・グループが動的である場合を除いて、キャッシュ・グループにLRUエージングを指定できません。AUTOREFRESH属性を指定したキャッシュ・グループが明示的にロードされている場合は、時間ベース・エージングを使用してください。

必要な権限

このプロシージャには、現在の値を問い合せるための権限は必要ありません。現在の値を変更するには、ADMIN権限が必要です。

構文

ttAgingLRUConfig([LowUsageThreshHold],
[HighUsageThreshHold], [AgingCycle])

パラメータ

ttAgingLRUConfigには、次のオプションのパラメータがあります。

パラメータ

データ型

説明

lowUsageThreshold

BINARY_FLOAT

データベースのPermSize割合の下限値を設定、表示またはリセットします(小数で指定)。これはしきい値範囲の最小値であり、この値を下回るとLRUエージングが停止します。デフォルトは80%です。

highUsageThreshold

BINARY_FLOAT

データベースのPermSize割合の上限値を設定、表示またはリセットします(小数で指定)。これはしきい値範囲の最大値であり、この値を上回るとLRUエージングがアクティブになります。デフォルトは90%です。

agingCycle

TT_INTEGER

エージングが実行されるサイクル間隔(分単位)を設定、表示またはリセットします。デフォルトは1分です。このプロシージャを使用してエージングのサイクル間隔を変更すると、サイクルは、このプロシージャがコールされる時間に基づいてリセットされます。たとえば、このプロシージャを午後12時にコールし、15分のサイクルを指定すると、エージングは、12時15分、12時30分、12時45分というように実行されます。
サイクルが値0に設定されると、エージングは1秒に一度実行されます。

結果セット

ttAgingLRUConfigは次の結果を返します。

列

データ型

説明

lowUsageThreshold

BINARY_FLOAT NOT NULL

データベースのPermSize割合の下限値に関する現在の設定(小数)。

highUsageThreshold

BINARY_FLOAT NOT NULL

データベースのPermSize割合の上限値に関する現在の設定(小数)。

agingCycle

TT_INTEGERNOT NULL

エージング・サイクル間の時間に関する現在の設定(分単位)。

例

エージングしきい値の下限を75%、上限を95%、エージング・サイクル間隔を5分に設定するには、次のように実行します。

CALL ttAgingLRUConfig (.75, .90, 5);
<.7500000, .9000000, 5>

LRUエージング・ポリシーを指定して定義したすべての表の現在のLRUエージング・ポリシーを表示するには、パラメータなしでttAgingLRUConfigをコールします。

Call ttAgingLRUConfig();

表がデフォルトのしきい値およびエージング・サイクルで定義される場合、プロシージャは次の結果を返します。

<.8000000, .9000000, 1>
1 row found.

しきい値の下限を60%、エージング・サイクルを5分に変更し、しきい値の上限は変更しない場合は、次のようにします。

Call ttAgingLRUConfig (60,,5);
< .6000000, .9000000, 5 >
1 row found.

注意

このプロシージャの値は、システム障害が発生した後でも維持されます。

パラメータを指定せずにこのプロシージャをコールすると、現在のLRUエージング属性設定が返されます。

関連項目

ttAgingScheduleNow
『Oracle TimesTen Application-Tier Database Cacheユーザーズ・ガイド』

ttAgingScheduleNow

説明

このプロシージャは、エージング・サイクルの値にかかわらずエージング・プロセスを開始します。進行中のエージング・プロセスが存在しないかぎり、プロシージャがコールされた直後にエージング・プロセスが開始されます。その場合、組込みプロシージャをコールしたときに進行中だったエージング・プロセスが完了すると、新しいエージング・プロセスが開始されます。

このプロシージャをコールすると、エージングは1回だけ行われます。このプロシージャではエージング属性は変更されません。以前のエージングの状態はそのままです。たとえば、ttAgingScheduleNowをコールしたときにエージングの状態がOFFの場合、エージング・プロセスが開始されます。エージングが完了したときに、エージングの状態がOFFの場合、エージングは続行されません。エージングを続行するには、エージング・サイクルの値に基づいて次にエージングが行われるように、ttAgingScheduleNowを再度コールするか、エージングの状態をONに変更する必要があります。

エージングがONになっている表の場合は、ttAgingScheduleNowがコールされた時点にエージング・サイクルがリセットされます。たとえば、午後12時にこのプロシージャをコールし、15分のエージング・サイクルを指定すると、エージングは、すぐに実行された後、12時15分、12時30分、12時45分というように再度実行されます。

このプロシージャをcronジョブなどの外部スケジューラで使用する場合や手動で実行する場合、このプロシージャは、進行中のエージング・プロセスがないときはプロシージャの実行時に、または現在のエージング・プロセスが完了するとすぐにエージング・プロセスを開始します。外部スケジューラがttAgingScheduleNowプロシージャを実行するか、または手動でコールしたときにのみエージングを行う場合は、エージングの状態をOFFに設定します。

エージングは、1秒ごとに起動して処理が必要かどうかをチェックするバックグラウンド・スレッドによって実行されます。ttAgingScheduleNowをコールしても、指定された表がエージング・スレッドによって処理されるのは次の1秒間になります。組込みプロシージャがコールされたときにエージング・スレッドが別の表を処理していた場合は、指定された表の処理が開始されるまでに多少時間がかかる可能性があります。エージング・スレッドによって削除がコミットされるまで、行は表示されています。

必要な権限

このプロシージャでは、エージングを実行する表に対するDELETE権限、または表を指定しない場合はDELETE ANY TABLE権限が必要です。

構文

ttAgingScheduleNow ('tblname')

パラメータ

ttAgingScheduleNowには、次のパラメータがあります。

パラメータ

データ型

説明

tblname

TT_CHAR (61)

エージング・プロセスを開始する表の名前です。
tblNameを省略すると、エージング・プロセスがエージング・ポリシーで定義されたすべての表で開始されます。

表名の指定にシノニムは使用できません。

結果セット

ttAgingScheduleNowは結果を返しません。

例

LRUエージングおよび時間ベース・エージングの両方が定義された表を含む、すべての表でエージングをスケジュールするには、パラメータ値を指定せずにttAgingScheduleNowをコールします。

CALL ttAgingScheduleNow ();

この例では、時間ベースのエージング・ポリシーを指定し、エージングの状態をOFFに設定した表agingexを作成します。エージング・プロセスを1回起動するために、ttIsqlユーティリティを使用してttAgingScheduleNowをコールします。行は表から削除されます。ttAgingScheduleNowをコールした後も、エージングの状態はOFFのままです。エージングを続行するには、表を変更し、エージング状態をOFFに設定します。

Command> CREATE TABLE agingex (col1 TT_INTEGER PRIMARY KEY NOT NULL,
ts TIMESTAMP NOT NULL)
AGING USE ts LIFETIME 1 MINUTES CYCLE 30 MINUTES OFF;

Command> DESCRIBE agingex;

Table TTUSER.AGINGEX:
Columns:
*COL1             TT_INTEGER NOT NULL
TS               TIMESTAMP (6) NOT NULL
Aging use TS lifetime 1 minute cycle 30 minutes off
1 table found.
(primary key columns are indicated with *)

Command> INSERT INTO agingex VALUES (1, SYSDATE);
1 row inserted.

Command> INSERT INTO agingex VALUES (2, SYSDATE);
1 row inserted.

Command> SELECT * FROM agingex;

< 1, 2011-03-25 13:06:29.000000 >
< 2, 2011-03-25 13:06:42.000000 >
2 rows found.

Command> CALL ttAgingScheduleNow ('agingex');

Command> SELECT * FROM agingex;
0 rows found.

関連項目

ttAgingLRUConfig
『Oracle TimesTen Application-Tier Database Cacheユーザーズ・ガイド』

ttApplicationContext

説明

このプロシージャは、アプリケーション固有のデータをXLAリーダーに渡すために、次の更新レコード(UPDATEまたはコミット)に対するアプリケーション定義のコンテキストを設定します。

必要な権限

このプロシージャには、権限は必要ありません。

構文

ttApplicationContext (cmd)

パラメータ

ttApplicationContextには、次のパラメータがあります。

パラメータ

データ型

説明

cmd

VARBINARY(16384) NOT NULL

XLAリーダーに渡されるコンテキスト情報。

結果セット

ttApplicationContextは結果を返しません。

例

CALL ttApplicationContext (0x123);

関連項目

『Oracle TimesTen In-Memory Database C開発者ガイド』のXLAリファレンスに関する説明

ttBackupStatus

説明

このプロシージャは、データベースの現在のバックアップまたは最後のバックアップに関する情報が含まれる単一の行を返します。バックアップが進行中の場合は、この情報は現在のバックアップのものになります。バックアップが行われていない場合は、この情報は最後に実行されたバックアップのものになります。

最後に初期接続を行った後にデータベースをバックアップしていない場合は、statusフィールドが0になり、その他の列はNULLになります。

必要な権限

このプロシージャには、ADMIN権限が必要です。

構文

ttBackupStatus ()

パラメータ

ttBackupStatusにパラメータはありません。

結果セット

ttBackupStatusは次の結果を返します。

列

データ型

説明

status

TT_INTEGERNOT NULL

バックアップの現在の進捗状況または最後のバックアップの完了状態を表すINTEGERコード。値は次のいずれかです。
0: 最後の初期接続の後、データベースで実行されたバックアップはありません。

1: バックアップは現在進行中です。

2: 最後のバックアップは正常に完了しました。

3: 最後のバックアップは失敗しました。この場合、エラー列には失敗を示すエラー・コードが含まれています。

destination

TT_INTEGER

実行されたバックアップのタイプ。データベースで実行されたバックアップがない場合、値はNULLです。次のいずれかの値です。
0: ファイルへのバックアップの書込みが行われているか、行われました。

1: ストリームへのバックアップの書込みが行われているか、行われました。

2: レプリケーション複製のかわりにバックアップが実行されているか、実行されました。

backupType

TT_INTEGER

バックアップのタイプ(全体または増分のいずれか)。データベースで実行されたバックアップがない場合、値はNULLです。次のいずれかの値です。
0 - 増分バックアップ。

1 - 全体バックアップ。

startTime

TT_TIMESTAMP

バックアップを開始した時間。データベースで実行されたバックアップがない場合、値はNULLです。

endTime

TT_TIMESTAMP

バックアップが完了した時間。この値がNULLで、startTimeがNULL以外の場合、バックアップは進行中です。

backupLFN

TT_INTEGER

バックアップ・ポイントのトランザクション・ログ・ファイル番号。データベースで実行されたバックアップがない場合、値はNULLです。

backupLFO

TT_BIGINT

バックアップ・ポイントのトランザクション・ログ・ファイルのオフセット。データベースで実行されたバックアップがない場合、値はNULLです。

error

TT_INTEGER

バックアップが失敗した場合、この列に失敗の理由が示されます。値は、TimesTenエラー番号のいずれかです。データベースで実行されたバックアップがない場合、値はNULLです。

processId

TT_INTEGER

バックアップを実行しているプロセスまたはデーモンのID(特定できる場合)。

例

CALL ttBackupStatus ();
< 2, 2, 1, 2005-08-12 13:10:32.587557,
2005-08-12 13:10:33.193269, 1, 1531840, 0, 6968 >
1 row found.

注意

現在のバックアップまたは最後のバックアップ以外の以前のバックアップに関する情報は返されません。

データベースが起動または停止されると、返される情報は永続的ではなくなります。

ttBlockInfo

説明

このプロシージャは、データベース内の永続ブロックおよびブロックレベルでの断片化の量に関する情報を提供します。

必要な権限

このプロシージャには、権限は必要ありません。

構文

ttBlockInfo()

パラメータ

ttBlockInfoにパラメータはありません。

結果セット

ttBlockInfoは次の結果セットを返します。

列

データ型

説明

TotalBlocks

TT_BIGINTNOT NULL

データベースのブロックの合計数。

FreeBlocks

TT_BIGINTNOT NULL

データベースの空きブロックの合計数。

FreeBytes

TT_BIGINTNOT NULL

空きブロックの合計サイズ。

LargestFree

TT_BIGINTNOT NULL

最大の空きブロックのサイズ。

例

CALL ttBlockInfo();
< 288, 3, 128711700, 128698596 >
1 row found.

ttBookmark

説明

このプロシージャは、TimesTenトランザクション・ログに関する情報を返します。トランザクション・ログ内のレコードは、次の整数のペアによって識別されます。

- トランザクション・ログ・ファイル番号。

- そのトランザクション・ログ・ファイルのオフセット。

トランザクション・ログ・ファイル番号は、トランザクション・ログ・ファイルに指定されたファイル・システム名に対応します。たとえば、トランザクション・ログ・ファイルSalesData.log29のトランザクション・ログ・ファイル番号は29です。

ttBookmarkの結果行では、次の3つのログ・レコードが識別されます。

- 最後に書き込まれたログ・レコードの識別。

- 最後にディスクに書き込まれたログ・レコードの識別。

- レプリケーション・ブックマーク。レプリケーション・ブックマークとは、更新が別のシステムへレプリケートされていないことを示す、最も古いログ・レコードのことです。

必要な権限

このプロシージャには、権限は必要ありません。

構文

ttBookmark()

パラメータ

ttBookmarkにパラメータはありません。

結果セット

ttBookmarkは次の結果セットを返します。

列

データ型

説明

writeLFN

TT_INTEGER

最後に書き込まれたトランザクション・ログ・ファイル。

writeLFO

TT_BIGINT

トランザクション・ログ・ファイルに最後に書き込まれたオフセット。

forceLFN

TT_INTEGER

最後にディスクに書き込まれたトランザクション・ログ・ファイル。

forceLFO

TT_BIGINT

最後にディスクに書き込まれたトランザクション・ログ・ファイルのオフセット。

holdLFN

TT_INTEGER

レプリケーション・ブックマークのトランザクション・ログ・ファイル。

holdLFO

TT_BIGINT

レプリケーション・ブックマークのログのオフセット。

例

CALL ttBookmark ();

ttCacheAllowFlushAwtSet

説明

ttCacheAllowFlushAwtSet組込みプロシージャは、AWTキャッシュ・グループに対してFLUSH CACHE GROUP文を実行できるようにし、『Oracle TimesTen In-Memory Database開発者および管理者ガイド』のキャッシュ・グループに非同期データが存在する場合に関する項に示すように、特定のリカバリ・シナリオでのみ使用されます。

enableFlushパラメータを1に設定している場合、ttCacheAllowFlushAwtSet組込みプロシージャを実行する前にAutocommitを無効に設定します(そうしない場合、このパラメータは、組込みプロシージャの実行後、直接自動的に0にリセットします)。その後、FLUSH CACHE GROUP文を実行してttCacheAllowFlushAwtSet組込みプロシージャを実行した後にコミットを実行して、enableFlushパラメータを0にリセットします。

必要な権限

このプロシージャには、権限は必要ありません。

構文

ttCacheAllowFlushAwtSet (enableFlush)

パラメータ

ttCacheAllowFlushAwtSetには、次のパラメータがあります。

パラメータ

データ型

説明

enableFlush

TT_INTEGER

0: AWTキャッシュ・グループに対してFLUSH CACHE GROUP文を実行できません(これは意図した制約です)。
1 - AWTキャッシュ・グループに対してFLUSH CACHE GROUP文を実行でき、『Oracle TimesTen In-Memory Database開発者および管理者ガイド』のキャッシュ・グループに非同期データが存在する場合に関する項に示すように、リカバリでのみ実行されます。

結果セット

ttCacheAllowFlushAwtSetは結果を返しません。

例

次の例では、ttCacheAllowFlushAwtSet組込みプロシージャを実行して、marketbasket AWTキャッシュ・グループに対して最初にFLUSH CACHE GROUP文の実行を許可し、その後禁止する方法を示します。

Command> set autocommit off;
Command> CALL ttCacheAllowFlushAwtSet(1);
Command> FLUSH CACHE GROUP marketbasket;
Command> CALL ttCacheAllowFlushAwtSet(0);
Command> COMMIT;

関連項目

『Oracle TimesTen In-Memory Database開発者および管理者ガイド』のキャッシュ・グループに非同期データが存在する場合に関する説明を参照してください。

ttCacheAutorefIntervalStatsGet

説明

ttCacheAutorefIntervalStatsGet組込みプロシージャは、特定の自動リフレッシュ間隔の過去10回の自動リフレッシュ・サイクルについての統計情報を返します。

必要な権限

このプロシージャには、権限は必要ありません。

構文

ttCacheAutorefIntervalStatsGet (autoRefInterval, isStatic)

パラメータ

ttCacheAutorefIntervalStatsGetには、次のパラメータがあります。

パラメータ

データ型

説明

autoRefInterval

TT_BIGINTNOT NULL

autorefreshIntervalは統計を収集するキャッシュ・グループ(この自動リフレッシュ間隔値のキャッシュ・グループ)を指定します。
自動リフレッシュ間隔(ミリ秒単位)の整数値は、自動リフレッシュの頻度を示すために自動リフレッシュ・キャッシュ・グループが作成されたときに最初に指定した値と同じ値です。

isStatic

TT_INTEGER

指定された間隔の値で静的キャッシュ・グループの情報を取得するか、動的キャッシュ・グループの情報を取得するかを示します。
0 - 動的キャッシュ・グループ

1: 静的(非動的)キャッシュ・グループ

デフォルトは静的です。

結果セット

ttCacheAutorefIntervalStatsGetは、特定の自動リフレッシュ間隔の過去10回の自動リフレッシュ・サイクルについての統計情報を返します。

列

データ型

説明

autorefInterval

TT_BIGINT

自動リフレッシュ間隔(ミリ秒)。

isStatic

TT_INTEGER

指定された間隔値で静的キャッシュ・グループまたは動的キャッシュ・グループの情報を示します。
0 - 動的キャッシュ・グループ

1: 静的(非動的)キャッシュ・グループ

autorefNumber

TT_BIGINT

自動リフレッシュ番号。

startTimestamp

TT_TIMESTAMP

自動リフレッシュ開始時間。

selectLimit

TT_BIGINT

増分自動リフレッシュ・キャッシュ・グループの行の制限セットを選択します。

numRows

TT_BIGINT

リフレッシュされる行数。

numOps

TT_BIGINT

実行されたSQL操作数。

numCommits

TT_BIGINT

コミット数。

commitBufSize

TT_BIGINT

最大コミット・バッファ・サイズ(バイト)。

commitBufMaxReached

TT_BIGINT

コミット処理に使用されたメモリー量(バイト)。

commitBufNumOverflows

TT_BIGINT

各トランザクションに対してオーバーフローしたコミット・バッファの回数。

totalNumRows

TT_BIGINT

自動リフレッシュ・スレッドが開始してからリフレッシュされた行数。

totalNumOps

TT_BIGINT

自動リフレッシュ・スレッドが開始してからSQL操作が実行された回数。

totalNumCommits

TT_BIGINT

自動リフレッシュ・スレッドが開始してからのコミット数。

totalNumRollbacks

TT_BIGINT

自動リフレッシュ・スレッドが開始してからのロールバック数。

totalNumSnapshotOld

TT_BIGINT

自動リフレッシュ・スレッドが開始してから受信した「Snapshot too old」エラーの数。

例

次の例では、静的であり7秒の間隔があると定義された自動リフレッシュ・キャッシュ・グループの統計を取得するための、ttCacheAutorefIntervalStatsGet組込みプロシージャを実行する方法を示しています。

Command> call ttCacheAutorefIntervalStatsGet(7000,1);

< 7000, 1, 41, 2013-04-25 15:17:00.000000, 0, 0, 0, 1, 0, 0, <NULL>,
132121, 132121, 13, 21, 0, 0, 0, 0 >
< 7000, 1, 40, 2013-04-25 15:16:53.000000, 0, 0, 0, 1, 0, 0, <NULL>,
132121, 132121, 12, 21, 0, 0, 0, 0 >
< 7000, 1, 39, 2013-04-25 15:16:46.000000, 0, 0, 0, 1, 0, 0, <NULL>,
132121, 132121, 11, 21, 0, 0, 0, 0 >
< 7000, 1, 38, 2013-04-25 15:16:39.000000, 0, 0, 0, 1, 0, 0, <NULL>,
132121, 132121, 10, 21, 0, 0, 0, 0 >
< 7000, 1, 37, 2013-04-25 15:16:32.000000, 0, 6305, 6305, 1, 0, 131072,
<NULL>, 132121, 132121, 9, 21, 0, 0, 0, 0 >
< 7000, 1, 36, 2013-04-25 15:16:24.000000, 0, 15616, 15616, 1, 0, 131072,
<NULL>, 125816, 125816, 8, 21, 0, 0, 0, 0 >
< 7000, 1, 35, 2013-04-25 15:16:17.000000, 0, 18176, 18176, 1, 0, 131072,
<NULL>, 110200, 110200, 7, 21, 0, 0, 0, 0 >
< 7000, 1, 34, 2013-04-25 15:16:10.000000, 0, 14336, 14336, 1, 0, 131072,
<NULL>, 92024, 92024, 6, 21, 0, 0, 0, 0 >
< 7000, 1, 33, 2013-04-25 15:16:03.000000, 0, 15360, 15360, 1, 0, 131072,
<NULL>, 77688, 77688, 5, 21, 0, 0, 0, 0 >
< 7000, 1, 32, 2013-04-25 15:15:56.000000, 0, 11520, 11520, 1, 0, 131072,
<NULL>, 62328, 62328, 4, 21, 0, 0, 0, 0 >

10 rows found.

注意

このプロシージャは、TimesTen Cacheでのみ使用可能です。

関連項目

ttCacheAutorefreshSelectLimit
ttCacheAutorefreshXactLimit
『Oracle TimesTen Application-Tier Database Cacheユーザーズ・ガイド』の増分自動リフレッシュ読取り専用キャッシュ・グループを使用する際の大規模なトランザクションの実行の向上に関する説明および増分自動リフレッシュ読取り専用キャッシュ・グループを使用する際の選択制限の構成に関する説明

ttCacheAutorefresh

説明

このプロシージャは、指定されたキャッシュ・グループと同じ自動リフレッシュ間隔を共有することで関連付けられている一連のキャッシュ・グループに対して、即時自動リフレッシュを開始します。通常は、この関連付けられた一連のキャッシュ・グループは、自動で同時にリフレッシュされます。自動リフレッシュ・プロセスへの影響は、指定されたキャッシュ・グループと同じリフレッシュ間隔を持つに新しいキャッシュ・グループを追加する場合と同じです。このプロシージャは、Oracle Databaseで更新が発生した場合に、次のスケジュールされた自動リフレッシュの前にキャッシュ・グループを更新したいときに役立ちます。

既存のトランザクションにロックされている表オブジェクトがあり、それらの表オブジェクトが自動リフレッシュの対象となる一連のキャッシュ・グループに属している場合、このプロシージャは何もアクションを行わずにエラーを返します。このプロシージャは、そのセッションで他の処理を実行する前にコミットまたはロールバックが必要であるという条件を設定します。

必要な権限

このプロシージャには、CACHE_MANAGERまたはADMIN権限が必要です。

構文

ttCacheAutorefresh ('cgOwner', 'cgName', synchronous)

パラメータ

ttCacheAutorefreshには、次のパラメータがあります。

パラメータ

データ型

説明

cgOwner

VARCHAR2 (30)

キャッシュ・グループの所有者の名前。

cgName

VARCHAR2 (30) NOT NULL

キャッシュ・グループの名前。

synchronous

TT_INTEGER

データを同期または非同期のどちらで更新するかを指定します。
0またはNULL: 非同期モード。プロシージャはすぐに戻ります。

1 - 同期モード。プロシージャは、すべての関連付けられたキャッシュ・グループでリフレッシュ処理が完了した後に戻ります。

結果セット

ttCacheAutorefreshは結果を返しません。

例

この例では、testcacheキャッシュ・グループおよび同じ自動リフレッシュ間隔を持つすべてのキャッシュ・グループに対して自動リフレッシュを行います。プロシージャは同期して戻ります。

Command> call ttcacheautorefresh('user1','testcache', 1);

注意

指定したキャッシュ・グループAUTOREFRESHの状態をONにする必要があります。一方、関連付けられた他のキャッシュ・グループの状態は任意で、自動リフレッシュの状態がONになっていない場合はリフレッシュされません。指定した関連キャッシュ・グループの自動リフレッシュは処理できません。このプロシージャをアクティブ・スタンバイ・ペアのスタンバイ・ノードに対してコールすることはできません。

このプロシージャは、TimesTen Cacheでのみ使用可能です。

ttCacheAutorefreshLogDefrag

説明

ttCacheAutorefreshLogDefrag組込みプロシージャは、キャッシュ自動リフレッシュ表のトリガー・ログ領域を圧縮します。

使用方法の詳細は、『Oracle TimesTen Application-Tier Database Cacheユーザーズ・ガイド』の表領域での変更ログ表のデフラグに関する説明を参照してください。

必要な権限

このプロシージャには、CACHE_MANAGER権限が必要です。

構文

ttCacheAutorefreshLogDefrag ('action')

パラメータ

ttCacheAutorefreshLogDefragには、次のパラメータがあります。

パラメータ

データ型

説明

action

VARCHAR (50) NOT NULL

許容値は次のとおりです。
Compact: トリガー・ログ領域のみをデフラグします。

CompactAndReclaim: トリガー・ログ領域およびトランザクション・コミット・バッファ(再利用領域)をデフラグします。

注意: 再利用フェーズでは短時間トリガー・ログ表をロックします。これにより、ワークロードの実表への書込みが一時停止する場合があります。

結果セット

ttCacheAutorefreshLogDefragは結果を返しません。

例

次の例では、コールはトリガー・ログ領域のみを圧縮またはデフラグします。

Command> call ttCacheAutorefreshLogDefrag('Compact');

注意

このプロシージャは、TimesTen Cacheでのみ使用可能です。

関連項目

ttCacheConfig
ttCacheAutorefreshStatsGet

ttCacheAutorefreshStatsGet

説明

このプロシージャは、指定されたキャッシュ・グループで実行された過去10回の自動リフレッシュ・トランザクションに関する情報を返します。この情報は、AUTOREFRESHの状態がONまたはPAUSEDで、キャッシュ・エージェントが実行中である場合のみ返されます。

この組込みプロシージャが返す情報は、次の場合に常にリセットされます。

- キャッシュ・エージェントが再起動された場合

- 状態がOFFに設定されてからONまたはPAUSEDに戻された場合

- キャッシュ・グループが削除されて再作成された場合

必要な権限

このプロシージャには、権限は必要ありません。

構文

ttCacheAutorefreshStatsGet ('cgOwner', 'cgname')

パラメータ

ttCacheAutorefreshStatsGetには、次のパラメータがあります。

パラメータ

データ型

説明

cgOwner

VARCHAR2 (30)

キャッシュ・グループの所有者の名前。

cgName

VARCHAR2 (30) NOT NULL

自動リフレッシュに関する情報を返すキャッシュ・グループの名前。

結果セット

ttCacheAutorefreshStatsGet組込みプロシージャは、自動リフレッシュ・モードがFULLのキャッシュ・グループには、列情報のサブセットのみを返します。入手できない情報に対しては列値0が返されます。

ttCacheAutorefreshStatsGetは次の結果を返します。

列名

列型

説明

完全自動リフレッシュで返されるか

cgId

TT_BIGINT

キャッシュ・グループID。

Y

startTimestamp

TT_TIMESTAMP

この時間隔で自動リフレッシュが開始された時間のタイムスタンプ。次の注意を参照してください。

Y

cacheAgentUpTime

TT_BIGINT

この時間隔で自動リフレッシュ・トランザクションが開始されてからのキャッシュ・エージェントの経過時間(ミリ秒)。この値は累積値で、キャッシュ・エージェント・プロセスが開始されるとリセットされます。次の注意を参照してください。

Y

autorefNumber

TT_BIGINT

キャッシュ・グループの自動リフレッシュ番号は、キャッシュ・エージェントの開始後にこのキャッシュ・グループが何回増分リフレッシュされたかを示します。キャッシュ・エージェントの開始時に、この番号は0に初期化されます。

Y

autorefDuration

TT_BIGINT

この自動リフレッシュ・トランザクションで経過した時間(ミリ秒)。

Y

autorefNumRows

TT_BIGINT

この自動リフレッシュで自動リフレッシュされた行数。ルート表および子表の行を含む、すべての行が含まれます。
複数の表が含まれるキャッシュ・グループの場合、子表の行は複数回更新されます。したがって、自動リフレッシュされる行の数は、Oracle Databaseで更新される行の数を超える場合があります。

N

numOracleBytes

TT_BIGINT

この自動リフレッシュ・トランザクションでOracle Databaseから転送されたバイト数。

N

autorefNumRootTblRows

TT_BIGINT

この自動リフレッシュ・トランザクションで自動リフレッシュされたルート表の行数。

Y

autorefQueryExecDuration

TT_BIGINT

Oracle Databaseで自動リフレッシュ問合せの実行にかかった時間(ミリ秒)。

N

autorefQueryFetchDuration

TT_BIGINT

自動リフレッシュ問合せでOracle Databaseからの行フェッチにかかった時間(ミリ秒)。

N

autorefTtApplyDuration

TT_BIGINT

TimesTenによる自動リフレッシュの適用にかかった時間(ミリ秒)。

N

totalNumRows

TT_BIGINT

キャッシュ・エージェントの起動後に自動リフレッシュされた行の合計数。
自動リフレッシュされる行の総数は、Oracle Databaseで更新される行の数とは異なる場合があります。これはログのマーキングの遅延によるもので、一部の更新は自動リフレッシュされて複数回カウントされる場合があります。

N

totalNumOracleBytes

TT_BIGINT

キャッシュ・エージェントの起動後にOracle Databaseから転送された総バイト数。

N

totalNumRootTblRows

TT_BIGINT

キャッシュ・エージェントの起動後に自動リフレッシュされたルート表の行の合計数。

Y

totalDuration

TT_BIGINT

キャッシュ・エージェントの起動後の自動リフレッシュの合計経過時間(ミリ秒)。

Y

status

VARCHAR2 (128)

現在の自動リフレッシュの状態を説明する文字列。次の注意を参照してください。このフィールドでサポートされている値は次のとおりです。
Complete

inProgress

Failed

Y

numlogrows

TT_BIGINT

この自動リフレッシュでOracle Databaseからフェッチされた行数。

Y

totalnumlogrows

TT_BIGINT

この自動リフレッシュでOracle Databaseからフェッチされた行の累積数。

Y

autorefLogFragmentationPct

TT_BIGINT

最低レベルの表使用率(パーセント)。表使用率が指定されたパーセントよりも低い場合には、表は圧縮されます。

Y

autorefLogFragmentationTs

TT_TIMESTAMP

使用率または断片率が最後に計算されたときのタイムスタンプ。

Y

autorefLogDefragGcnt

TT_BIGINT

表が圧縮された回数。

Y

例

この例では、testcacheは、1つの表を持ち、増分自動リフレッシュ時間隔が10秒のREADONLYキャッシュ・グループです。

Command> call ttcacheautorefreshstatsget('user1','testcache');

< 1164260, 2011-07-23 15:43:52.000000, 850280, 44,
0, 75464, 528255, 75464, 310, 110, 6800, 1890912,
12439795, 1890912, 160020, InProgress, 2, 74 >
< 1164260, 2011-07-23 15:43:33.000000, 831700, 43,
13550, 108544, 759808, 108544, 1030, 230, 12290, 1815448,
11911540, 1815448, 160020, Complete, 2, 72 >
< 1164260, 2011-07-23 15:43:12.000000, 810230, 42,
17040, 115712, 809984, 115712, 610, 330, 16090, 1706904,
11151732, 1706904, 146470, Complete, 2, 70>
< 1164260, 2011-07-23 15:42:52.000000, 790190, 41,
14300, 94208, 659456, 94208,560, 320, 13410, 1591192,
10341748, 1591192, 129430, Complete, 2, 68 >
< 1164260, 2011-07-23 15:42:32.000000, 770180, 40,
12080, 99328, 695296, 99328,450, 290, 11340, 1496984,
9682292, 1496984, 115130, Complete, 2, 66 >
< 1164260, 2011-07-23 15:42:12.000000, 750130, 39,
10380, 86016, 598368, 86016,430, 230, 9720, 1397656,
8986996, 1397656, 103050, Complete, 2, 64 >
< 1164260, 2011-07-23 15:41:52.000000, 730130, 38,
13530, 112640, 700768, 112640, 530, 220, 12780, 1311640,
8388628, 1311640, 92670, Complete, 2, 62 >
< 1164260, 2011-07-23 15:41:32.000000, 710120, 37,
9370, 56320, 326810, 56320, 310, 160, 8900, 1199000,
7687860, 1199000, 79140, Complete, 2, 60 >
< 1164260, 2011-07-23 15:41:22.000000, 700120, 36,
2120, 10240, 50330, 10240, 50, 200, 1870, 1142680,
7361050, 1142680, 69770, Complete, 2, 58 >
< 1164260, 2011-07-23 15:41:12.000000, 690110, 35,
0, 0, 0, 0, 0, 0, 0, 1132440, 7310720, 1132440,
67650, Complete, 2, 56 >
10 rows found.

注意

ここでレポートされているほとんどの列値は、キャッシュ・グループ・レベルで収集されます。たとえば、autorefDurationおよびautorefNumRowsには、指定したキャッシュ・グループの情報のみが含まれます。このルールの例外は、列値cacheAgentUpTime、startTimestampおよびautorefreshStatusです。これらの値は、自動リフレッシュ時間隔レベルでレポートされます。

StartTimestampは、自動リフレッシュ時間隔における自動リフレッシュの開始時に取得されます。キャッシュ・グループは、時間隔の自動リフレッシュが開始されるとただちにin progress状態になります。時間隔のすべてのキャッシュ・グループの自動リフレッシュが完了すると、completeとマークされます。

このプロシージャは、TimesTen Cacheでのみ使用可能です。

ttCacheAutorefreshSelectLimit

説明

Oracle Databaseの実表を自動リフレッシュ変更ログ表の制限された行数と結合するために増分自動リフレッシュを設定することは、選択制限の設定として知られています。これはttCacheAutorefreshSelectLimit組込みプロシージャで実行できます。

必要な権限

このプロシージャにはADMINまたはCACHE_MANAGER権限が必要です。

構文

ttCacheAutorefreshSelectLimit ( autorefreshInterval, value )

パラメータ

ttCacheAutorefreshSelectLimitには、次のパラメータがあります。

パラメータ

データ型

説明

autorefreshInterval

TT_VARCHAR (30) NOT NULL

autorefreshIntervalはvalueを適用するキャッシュ・グループ(この自動リフレッシュ間隔値のキャッシュ・グループ)を指定します。
自動リフレッシュ間隔(ミリ秒単位)の整数値は、自動リフレッシュの頻度を示すために自動リフレッシュ・キャッシュ・グループが作成されたときに最初に指定した値と同じ値です。

value

TT_VARCHAR(30)

valueは、キャッシュ表に適用する自動リフレッシュ変更ログ・ファイルから選択した行数の制限を示します。これらの変更は自動リフレッシュ変更ログ表のすべての行が適用されるまで、増分的に適用されます。
値が変更された場合、その変更は次の自動リフレッシュ・サイクルの開始時に適用されます。

valueは次のいずれかになります。

- 'ON': 自動リフレッシュ変更ログ表から一度に最大1000行選択してすべての自動リフレッシュ・サイクルに適用します。

- number: 自動リフレッシュ・サイクル時に自動リフレッシュ変更ログ表からのユーザー指定の最大行数を選択します。ユーザーが制限サイズを2000に指定した場合、自動リフレッシュは自動リフレッシュ変更ログ表から最大2000行を一度に選択します。負の数字を指定した場合には、エラーが返されます。

- 'OFF': 選択制限を無効にします。増分自動リフレッシュは自動リフレッシュ・サイクル時に変更ログ表からすべての行を選択します。

- NULL: 指定したvalueがNULLまたは指定されていない場合、現在の設定が返されます。

結果セット

ttCacheAutorefreshSelectLimitは特定の自動リフレッシュ間隔に設定された次の選択制限の値を返します。

列

データ型

説明

autorefreshInterval

TT_VARCHAR(30)

autorefreshIntervalはキャッシュ・グループ(この自動リフレッシュ間隔値のキャッシュ・グループ)を指定します。

value

TT_VARCHAR(30)

現在のvalueは、キャッシュ表に適用する自動リフレッシュ変更ログ・ファイルから選択された行数を示します。

例

NULL値を指定するか、パラメータを指定しないことで現在の設定を表示できます。次の例では間隔値が7秒の増分自動リフレッシュ・キャッシュ・グループの設定を表示します。

Command> call ttCacheAutorefreshSelectLimit('7000', NULL);
< 7000, 2000 >
1 row found.
Command> call ttCacheAutorefreshSelectLimit('7000');
< 7000, 2000 >
1 row found.

次の例では間隔値が7秒の増分自動リフレッシュ・キャッシュ・グループに対して選択制限を2000行に設定しています。

Command> call ttCacheAutorefreshSelectLimit('7000', '2000');
< 7000, 2000 >
1 row found.

注意

- このプロシージャは、TimesTen Cacheでのみ使用可能です。

- ttCacheAutotrefreshSelectLimit組込みプロシージャは、キャッシュ・グループが増分自動リフレッシュを設定した静的読取り専用キャッシュ・グループとして定義されている1つの表を含む単一のキャッシュ・グループに定義した間隔のみに選択制限を設定できます。

- ttCacheAutorefreshSelectLimitの設定は、レプリケートまたは複製されません。ユーザーは、アクティブ・ノードおよびスタンバイ・ノードの両方において組込みを実行する必要があります。

- その間隔のすべてのキャッシュ・グループを削除した場合、設定はリセットされません。

- ttMigrate、ttBackup、ttRestore組込みプロシージャは、ttCacheAutorefreshSelectLimitの設定を保存しません。

- キャッシュ・グループ自動リフレッシュ間隔を変更する場合、キャッシュ・グループに対してttCacheAutorefreshSelectLimitの実行を介して以前設定された内容は変更されません。ttCacheAutorefreshSelectLimit組込みプロシージャでキャッシュ・グループの選択制限のみを変更できます。

関連項目

ttCacheAutorefIntervalStatsGet
『Oracle TimesTen Application-Tier Database Cacheユーザーズ・ガイド』の増分自動リフレッシュ読取り専用キャッシュ・グループを使用する際の選択制限の構成に関する説明

ttCacheAutorefreshXactLimit

説明

このプロシージャは、指定された自動リフレッシュ間隔内で、単一表のキャッシュ・グループに対して即時自動リフレッシュを行う間隔を指定し、指定された数の操作の後にコミットします。

このプロシージャは、Oracle Databaseで更新が発生した場合に、次のスケジュールされた自動リフレッシュの前にキャッシュ・グループで更新をリフレッシュしたいときに役立ちます。

再利用バッファ・サイズを変更するには、ttDBConfig組込みプロシージャを使用します。

必要な権限

このプロシージャには、CACHE_MANAGERまたはADMIN権限が必要です。

構文

ttCacheAutorefreshXactLimit ('IntervalValue', 'Value')

パラメータ

ttCacheAutorefreshXactLimitには、次のパラメータがあります。

パラメータ

データ型

説明

intervalValue

VARCHAR2 (50) NOT NULL

自動リフレッシュ・キャッシュ・グループの実行が定義される間隔をミリ秒の単位で指定します。IntervalValueは、自動リフレッシュ・キャッシュ・グループが作成されたときに指定された、自動リフレッシュの頻度を示すミリ秒単位の整数です。

value

VARCHAR2 (200)

Valueは、次のいずれかになります。

- 'ON': 256回の操作後ごとに自動リフレッシュがコミットされるようにします。

- 'OFF': 自動リフレッシュ・キャッシュ・グループのトランザクション制限を無効にし、自動リフレッシュが単一のトランザクションを使用するように設定し直します。

- number: 何回の操作後にコミットするかを示します。たとえば、ユーザーが1024を指定した場合、トランザクションで1024回の操作ごとに自動リフレッシュをコミットします。負の数字を指定した場合には、エラーが返されます。

- NULL: 値がNULL、0または指定されない場合には、現在の設定が返されます。

結果セット

ttCacheAutorefreshXactLimitは次の結果を返します。

列

データ型

説明

intervalValue

VARCHAR2 (50) NOT NULL

自動リフレッシュ・キャッシュ・グループの実行が定義される間隔(ミリ秒)。

value

VARCHAR2 (200)

Valueは、次のいずれかになります。

- 'ON': 256回の操作後ごとに自動リフレッシュがコミットされるようにします。

- 'OFF': 自動リフレッシュ・キャッシュ・グループのトランザクション制限を無効にし、自動リフレッシュが単一のトランザクションを使用するように設定し直します。

- number: 何回の操作後にコミットするかを示します。たとえば、ユーザーが1024を指定した場合、トランザクションで1024回の操作ごとに自動リフレッシュをコミットします。負の数字を指定した場合には、エラーが返されます。

- NULL: 値がNULLまたは指定されない場合には、現在の設定が返されます。

例

次の例では、10秒の間隔値で定義されたすべての増分自動リフレッシュ読取り専用キャッシュ・グループに対し、トランザクション制限を256回の操作後ごとにコミットするように設定しています。

call ttCacheAutorefreshXactLimit('10000', 'ON');

月末の処理が完了し、増分自動リフレッシュ読取り専用キャッシュ・グループがリフレッシュされた後、10秒の間隔値で定義された増分自動リフレッシュ読取り専用キャッシュ・グループに対し、トランザクション制限を無効にします。

call ttCacheAutorefreshXactLimit('10000', 'OFF');

増分自動リフレッシュ読取り専用キャッシュ・グループが2000回の操作後ごとにコミットするようにトランザクション制限を有効にするには、次のように2000を値として指定します。

call ttCacheAutorefreshXactLimit('10000', '2000');

注意

- このプロシージャは、TimesTen Cacheでのみ使用可能です。この組込みプロシージャは、増分自動リフレッシュを備えた静的読取りキャッシュ・グループにのみ適用されます。

- 自動リフレッシュが実行中および複数の小さいトランザクションに適用されている間は、トランザクション一貫性は維持できません。自動リフレッシュ・サイクルが完了すると、データはトランザクション一貫性があります。

- ttCacheAutorefreshXactLimitの設定は、レプリケートまたは複製されません。ユーザーは、アクティブ・ノードおよびスタンバイ・ノードの両方で組込みプロシージャを実行する必要があります。

- その間隔のすべてのキャッシュ・グループを削除した場合、設定はリセットされません。

- ttMigrate、ttBackup、ttRestore組込みプロシージャは、ttCacheAutorefreshXactLimitの設定を保存しません。

- キャッシュ・グループの自動リフレッシュ間隔を変更しても、ttCacheAutorefreshXactLimitの設定は変更されません。

関連項目

ttCacheAutorefIntervalStatsGet
『Oracle TimesTen Application-Tier Database Cacheユーザーズ・ガイド』の増分自動リフレッシュ読取り専用キャッシュ・グループを使用する際の大規模なトランザクションの実行の向上に関する説明

ttCacheAWTMonitorConfig

説明

このプロシージャを使用すると、監視を有効にして、AWTキャッシュ・グループのワークフローの各コンポーネントに費やされた時間を確認できます。監視結果を表示するには、-awtmoninfoおよび-showstatusオプションを指定してttRepAdminユーティリティを使用します。

レプリケーション・エージェントが起動されると、監視は無効になります。監視状態をOFFに設定すると、監視ツールの内部カウンタがリセットされます。

このプロシージャは、AWTの変更をOracle Databaseにレプリケートしているレプリケーション・ノードで実行します。アクティブ・スタンバイ・ペアが正常に機能している場合、AWTの変更をレプリケートするノードがスタンバイ・ノードです。アクティブ・ノードがスタンドアロンで動作している場合は、AWTの変更をレプリケートしているノードがアクティブ・ノードになります。

アクティブ・データベースのあるノードで障害が発生した場合、スタンバイ・ノードが新しいアクティブ・ノードになります。その場合は、このプロシージャを新しいアクティブ・ノードに対して実行します。

必要な権限

このプロシージャには、CACHE_MANAGER権限が必要です。

構文

ttCacheAWTMonitorConfig (['state'], [samplingRate])

パラメータ

ttCacheAWTMonitorConfigには、次のオプションのパラメータがあります。

パラメータ

データ型

説明

state

TT_CHAR(10)

AWT監視を有効および無効にします。値は、ONまたはOFFです。デフォルトはOFFです。

samplingRate

TT_INTEGER

AWTワークフローがサンプリングされる頻度を指定する正の整数。samplingRateを1に設定すると、すべてのAWT処理が監視されます。値が大きいほど、サンプリングの頻度は低くなります。正確性とパフォーマンスの観点から推奨される値は16です。stateがONに設定されている場合、samplingRateのデフォルトは16です。stateがOFFに設定されている場合、samplingRateのデフォルトは0です。

結果セット

パラメータを何も指定しない場合、ttCacheAWTMonitorConfigは次の結果を返します。レプリケーション・エージェントが実行中でない場合、またはAWTキャッシュ・グループが作成されていない場合は、エラーを返します。

列

データ型

説明

state

TTVARCHAR (10) NOT NULL

AWT監視の現在の状態。値は、ONまたはOFFです。

AWTSamplingFactor

TT_INTEGERNOT NULL

AWTワークフローがサンプリングされる頻度を指定する正の整数。

例

例2-1

監視が無効な場合、現在の状態とサンプリング係数を取得します。

Command> CALL ttCacheAWTMonitorConfig;
< OFF, 0 >
1 row found.

例2-2

監視を有効にし、サンプリング係数を16に設定します。

Command> CALL ttCacheAWTMonitorConfig ('ON', 16);
< ON, 16 >
1 row found.

例2-3

監視を無効にします。

Command> CALL ttCacheAWTMonitorConfig; ('OFF')
< OFF, 0 >
1 row found.

関連項目

「ttRepAdmin」

ttCacheAWTThresholdGet

説明

このプロシージャは、AWTキャッシュ・グループを含むデータベースの、現在のトランザクション・ログ・ファイルのしきい値を返します。

必要な権限

このプロシージャには、権限は必要ありません。

構文

ttCacheAWTThresholdGet()

パラメータ

ttCacheAWTThresholdGetにパラメータはありません。

結果セット

ttCacheAWTThresholdGetは次の結果を返します。

列

データ型

説明

threshold

TT_INTEGERNOT NULL

データベースに関連付けられたすべてのAWTキャッシュ・グループのトランザクション・ログ・ファイルの数。結果が0の場合、制限は設定されていません。

例

CALL ttCacheAWTThresholdGet();

注意

このプロシージャは、TimesTen Cacheでのみ使用可能です。

関連項目

ttCacheAWTThresholdSet

ttCacheAWTThresholdSet

説明

このプロシージャは、AWTが停止しているか、または大幅な遅延が発生しているとみなされるまでに蓄積されるトランザクション・ログ・ファイル数のしきい値を示します。この設定は、データベースのすべてのサブスクライバに適用されます。しきい値を超えた場合、更新はOracle Databaseに送信されなくなります。しきい値が設定されてない場合のデフォルトは、0(ゼロ)です。

この組込みプロシージャを使用すると、AWTキャッシュ・グループが作成された後にしきい値を設定できます。

この設定は、データベースのログ障害しきい値をリセットするCREATE REPLICATION文によって上書きできます。

必要な権限

このプロシージャには、CACHE_MANAGER権限が必要です。

構文

ttCacheAWTThresholdSet(threshold)

パラメータ

ttCacheAWTThresholdSetには、次のパラメータがあります。

パラメータ

データ型

説明

threshold

TT_INTEGER

データベースに関連付けられたすべてのAWTキャッシュ・グループのトランザクション・ログ・ファイルの数を指定します。しきい値がNULLの場合、ログ障害しきい値は0(ゼロ)に設定されます。

結果セット

ttCacheAWTThresholdSetは結果を返しません。

例

蓄積可能なトランザクション・ログ・ファイルのしきい値に12を設定するには、次のように実行します。

CALL ttCacheAWTThresholdSet(12);

注意

このプロシージャは、TimesTen Cacheで使用可能です。

しきい値を超えたときのリカバリは、ユーザーが行います。

関連項目

ttCacheAWTThresholdGet

ttCacheCheck

説明

ttCacheCheck組込みプロシージャは、Oracle Database上のキャッシュされた表に対する制約が失われていないかをチェックします。

キャッシュされるOracle Database表の列に対する任意の一意索引、一意制約または外部キー制約は、TimesTen内の非同期ライトスルー・キャッシュ表でも作成する必要があります。これらの制約をAWTキャッシュ表に作成しておらず、キャッシュ・グループをパラレル伝播用に構成している場合には、TimesTenは制約が失われている表に対するDML操作によってトランザクションをシリアライズします。

このプロシージャでは、失われている制約およびシリアライズされた伝播用にマークされた表についての情報が提供されます。

失われている制約を手動でチェックするには、次の状況でttCacheCheckをコールします。

- 一連のDROP CACHE GROUP文の完了後。

- Oracle Database上で一意索引または外部キーを作成または削除した後。

- 複数のトランザクションがシリアライズされている理由を判断するため。

このプロシージャは、表に対して実行されたDMLがシリアライズされる必要があるかないかを示すためにシステム表を更新します。したがって、ttCacheCheck組込みの完了後に、コミットまたはロールバックする必要があります。

パラレル伝播の詳細は、『Oracle TimesTen Application-Tier Database Cacheユーザーズ・ガイド』のOracle Database表へのパラレル伝播の構成に関する説明を参照してください。

必要な権限

このプロシージャには、CACHE_MANAGER権限が必要です。

構文

ttCacheCheck('operation', cgOwner, cgName)

パラメータ

ttCacheCheckには、次のパラメータがあります。

パラメータ

データ型

説明

operation

TT_VARCHAR(30)

チェックする制約を指定します。有効な値は次のとおりです。

- ForeignKey: 外部キー制約をチェックします。

- Unique: 一意制約をチェックします。

- Awt: 外部キー制約および一意制約の両方をチェックします。

- NULL: 外部キー制約および一意制約の両方をチェックします。

cgOwner

TT_VARCHAR(30)

キャッシュされたOracle Database表の所有者を指定します。
NULLの場合、接続ユーザーが所有するすべての非同期ライトスルー・キャッシュ・グループをチェックします。

cgOwnerおよびcgNameの両方ともNULLの場合、すべての非同期キャッシュ・グループをチェックします。

cgName

TT_VARCHAR(30)

キャッシュされたOracle Database表の名前を指定します。
NULLであって、cgOwnerが指定されている場合、cgOwnerに所有されるすべての非同期ライトスルー・キャッシュ・グループをチェックします。

cgOwnerおよびcgNameの両方ともNULLの場合、すべての非同期キャッシュ・グループをチェックします。

結果セット

ttCacheCheckは、次の結果セットを返します。

列

データ型

値

cgOwner

TT_VARCHAR (30) NOT NULL

キャッシュ・グループの所有者。

cgName

TT_VARCHAR (30) NOT NULL

キャッシュ・グループの名前。

tblOwner

TT_VARCHAR(30)

表の所有者。

tblName

TT_VARCHAR(30)

表の名前。

objectType

TT_VARCHAR(15)

Oracleオブジェクトのタイプ: 一意索引、制約または外部キー。

objectOwner

TT_VARCHAR(30)

Oracleオブジェクトの所有者。

objectName

TT_VARCHAR(30)

オブジェクト名。

msgType

TT_SMALLINT NOT NULL

メッセージの種類。
0 = 情報

1 = 警告

-1 = エラー

msg

TT_VARCHAR (100000) NOT NULL

問題を説明するメッセージ。

objectDesc

VARCHAR2(200000)

オブジェクトの説明。オブジェクトがAWTチェックの場合、説明はオブジェクトを記述するSQL文になります。

例

次の例では、cacheuserが所有するキャッシュ・グループupdate_ordersにおいて失われている制約がないかどうかを判定しています。警告メッセージを含む結果セットが返されます。update_ordersキャッシュ・グループのordertab表は、逐次伝播されたトランザクションであると示されています。

Command> call ttCacheCheck( NULL, 'cacheuser', 'update_orders');

< CACHEUSER, UPDATE_ORDERS, CACHEUSER, ORDERTAB, Foreign Key, CACHEUSER,
CUST_FK, 1, Transactions updating this table will be serialized to Oracle
because: The missing foreign key connects two AWT cache groups.,
table CACHEUSER.ORDERTAB constraint CACHEUSER.CUST_FK foreign key(CUSTID)
references CACHEUSER.ACTIVE_CUSTOMER(CUSTID) >
1 row found.

注意

このプロシージャは、TimesTen Cacheでのみ使用可能です。

関連項目

ttCacheDbCgStatus
ttCachePolicyGet
ttCachePolicySet
ttCacheStart
ttCacheStop
ttCacheUidGet
ttCacheUidPwdSet
「ttAdmin」

ttCacheConfig

説明

同じOracleインスタンスのデータをキャッシュするすべてのキャッシュ・グループに対し、このプロシージャは、Oracle Databaseサーバーが使用不可になっており、キャッシュ・エージェントまたはデータベースが停止しているとみなされる場合の、タイムアウト値とリカバリ・ポリシーを指定します。

データベースとキャッシュ・グループの自動リフレッシュの状態は、プロシージャttCacheDbCgStatusで確認できます。

必要な権限

このプロシージャには、CACHE_MANAGER権限が必要です。

構文

ttCacheConfig(Param, tblOwner, tblName, Value)

パラメータ

ttCacheConfigには、次のパラメータがあります。

パラメータ

データ型

説明

Param

VARCHAR2(50)
NOT NULL

Valueで設定するパラメータを指定します。

- AgentFailoverTimeout: Oracle RAC環境で作業している場合、TAFタイムアウトの値を分単位で設定します。接続を確立する際にTAFが再試行を行う時間を指定します。デフォルトは4分です。

- AgentTimeout: キャッシュ・エージェントがOracle Databaseサーバーに接続できないときにデータベースが停止していると宣言されるまでの秒数を指定します。

- AutoRefreshLogFragmentationWarningPCT: ユーザーに表を圧縮するように警告する前までの表の使用率(パーセント)。

- AutoRefreshLogDeFragmentAction: 指定した表の圧縮モード。

- AutoRefreshLogTblSpaceUsagePCT: キャッシュ管理ユーザーの表領域使用量の警告しきい値を割合で指定します。

- DeadDbRecovery: キャッシュ・エージェントが再起動される場合の自動リフレッシュ・リカバリのタイプを指定します。

- TblSpaceFullRecovery: キャッシュされたOracle Database表が更新され、キャッシュ管理ユーザーの表領域に空きがない場合に、TimesTenで実行するアクションを指定します。

tblOwner

VARCHAR2(30)

キャッシュされたOracle Database表の所有者を指定します。
このパラメータは、ParamがTblspaceFullRecoveryに設定されている場合は必須です。Paramの他の値に対しては、tblOwnerを指定しないでください。

表名の指定にシノニムは使用できません。

tblName

VARCHAR2(30)

キャッシュされたOracle Database表の名前を指定します。
このパラメータは、ParamがTblspaceFullRecoveryに設定されている場合は必須です。Paramの他の値に対しては、tblOwnerを指定しないでください。

表名の指定にシノニムは使用できません。

Value

VARCHAR2(200)

Paramに設定する値を指定します。

- ParamがAgentFailoverTimeoutの場合、Oracle RAC環境で作業中に接続の確立をする際にTAFが試行を行うまでの時間(分)を指定します。デフォルトは4分です。

- ParamがAgentTimeoutの場合、キャッシュ・エージェントがOracle Databaseサーバーに接続できないときにデータベースが停止していると宣言されるまでの秒数を指定します。デフォルトの0は、データベースが停止していると宣言されないことを意味します。

- ParamがAutoRefreshLogFragmentationWarningPCTの場合、4番目のパラメータの値は、表の割合を示す1から100の間の整数である必要があります。

- ParamがAutoRefreshLogDeFragmentActionの場合、値Manual、CompactOnlyまたはCompactandReclaimを取ることができます。Manualが指定された場合、何も行われません。ユーザーは、ttCacheAutorefreshLogDefrag組込みプロシージャを実行してログをデフラグできます。CompactOnlyが指定された場合には、トリガー・ログ領域が圧縮されます。CompactandReclaimが指定された場合、トリガー・ログ領域とトランザクション・ログ・バッファ(再利用領域)の両方が圧縮されます。デフォルトはManualです。

- ParamがAutoRefreshLogTblSpaceUsagePCTの場合、0から100の値になります。デフォルトの0は、表領域の使用量に関係なく警告が返されないことを意味します。

- ParamがDeadDbRecoveryの場合、値はNormalまたはManualのいずれかです。Normalは、完全自動リフレッシュを指定します。Manualは、REFRESH CACHE GROUP文を発行する必要があることを指定します。デフォルトはNormalです。

- ParamがTblSpaceFullRecoveryの場合、値はReloadまたはNoneのいずれかです。Reloadは、変更ログ表から行が削除され、完全自動リフレッシュが実行されることを指定します。Noneは、キャッシュされたOracle Database表が更新された場合にOracle Databaseエラーが返されることを指定します。デフォルトはNoneです。

あるいは、AwtErrorXmlOutputに設定される値を指定します。

- ASCII: AWTエラー・レポートを含むテキスト・ファイル。(デフォルト)

- XML: AWTエラー・レポートを含むXMLファイルおよび関連するDTDファイル。

結果セット

ttCacheConfigは、アプリケーションによりパラメータ値の設定に使用される場合、結果を返しません。パラメータ設定を返す目的で使用される場合、ttCacheConfigは次の結果を返します。

列

データ型

値

Param

VARCHAR2(50)

パラメータ名は、次のいずれかです。
AgentTimeout

AgentFailoverTimeout

AutoRefreshLogTblSpaceUsagePCT

DeadDbRecovery

TblSpaceFullRecovery

tblOwner

VARCHAR2(30)

キャッシュされたOracle Database表の所有者。

tblName

VARCHAR2(30)

キャッシュされたOracle Database表の名前。
表名の指定にシノニムは使用できません。

Value

VARCHAR2(200)

Paramの値セットです。

- ParamがAgentTimeoutの場合、キャッシュ・エージェントがOracle Databaseサーバーに接続できないときにデータベースが停止していると宣言されるまでの秒数を指定します。

- ParamがAutoRefreshLogTblSpaceUsagePCTの場合、0から100の値になります。

- ParamがDeadDbRecoveryの場合、値はNormalまたはManualのいずれかです。

- ParamがTblSpaceFullRecoveryの場合、値はReloadまたはNoneのいずれかです。

例

キャッシュ・エージェントのタイムアウトを600秒(10分)に設定するには、次のように入力します。

CALL ttCacheConfig('AgentTimeout',,,'600');

キャッシュ・エージェントの現在のタイムアウト設定を確認するには、次のように入力します。

CALL ttCacheConfig('AgentTimeout');
< AgentTimeout, <NULL>, <NULL>, 600 >
1 row found.

自動リフレッシュ状態がdeadのキャッシュ・グループに対して、リカバリ方法をManualに設定するには、次のように入力します。

CALL ttCacheconfig('DeadDbRecovery',,,'Manual');

キャッシュされたOracle Database表に更新があり、キャッシュ管理ユーザーの表領域に空きがない場合に、自動完全リフレッシュを防ぎ、Oracle Databaseエラーを受信するようにTimesTenキャッシュを構成します。Oracle Database表はterry.customerです。

CALL ttCacheConfig('TblSpaceFullRecovery','terry','customer','None');

キャッシュされたOracle Database表terry.customerのTblSpaceFullRecoveryについて現在の設定を確認するには、次のように入力します。

CALL ttCacheConfig('TblSpaceFullRecovery','terry','customer');
< TblSpaceFullRecovery, TERRY, CUSTOMER, none >
1 row found.

キャッシュ管理ユーザーの表領域が85%使用されているときに、キャッシュされたOracle Database表に対する更新処理が発生した場合に警告を受け取るようにするには、次のように入力します。

CALL ttCacheConfig('AutoRefreshLogTblSpaceUsagePCT',,,'85');

Oracle RAC環境で作業している場合、次のようにフェイルオーバー・タイムアウトの値を取得します。

Command> call ttCacheConfig('AgentFailoverTimeout');
< AgentFailoverTimeout, <NULL>, <NULL>, 4 >
1 row found.
.

次の例では、フェイルオーバー・タイムアウトを5分に設定しています。

Command> call ttCacheConfig('AgentFailoverTimeout',,,5);
< AgentFailoverTimeout, <NULL>, <NULL>, 5 >
1 row found.
Command>

注意

このプロシージャは、TimesTen Cacheでのみ使用可能です。

ttCacheConfig組込みプロシージャは、キャッシュ・グリッドまたはアクティブ・スタンバイ・ペアの各ノードからコールする必要があります。

関連項目

ttCacheDbCgStatus
ttCachePolicyGet
ttCachePolicySet
ttCacheStart
ttCacheStop
ttCacheUidGet
ttCacheUidPwdSet
「ttAdmin」
『Oracle TimesTen Application-Tier Database Cacheユーザーズ・ガイド』のAWTキャッシュ・グループでのOracle Database永続エラーのレポートに関する説明、キャッシュ環境の管理に関する説明およびOracle RAC環境でのTimesTen Cacheの設定に関する説明(エージェント・フェイルオーバーに関して)

ttCacheDbCgStatus

説明

このプロシージャは、データベースおよび指定されたキャッシュ・グループの自動リフレッシュの状態を返します。パラメータに値を指定しない場合、プロシージャはデータベースの自動リフレッシュの状態を返します。

必要な権限

このプロシージャには、権限は必要ありません。

構文

ttCacheDbCgStatus([cgOwner], [cgName])

パラメータ

ttCacheDbCgStatusには、次のオプションのパラメータがあります。

パラメータ

データ型

説明

cgOwner

VARCHAR2(30)

キャッシュ・グループ所有者のユーザー名を指定します。

cgName

VARCHAR2(30)

キャッシュ・グループ名を指定します。

結果セット

ttCacheDbCgStatusは次の結果を返します。

列

データ型

値

dbStatus

VARCHAR2(20)

データベース内のすべてのキャッシュ・グループの自動リフレッシュの状態を指定します。次のいずれかの状態になります。
alive: データベースはアクティブです。すべてのキャッシュ・グループの状態はokです。キャッシュ・エージェントは、Oracle Databaseサーバーに繋がっています。

dead - キャッシュ・エージェントはタイムアウト時間内にOracle Databaseに接続できませんでした。すべてのキャッシュ・グループのAUTOREFRESH属性の状態はterminatedです。

recovering: AUTOREFRESH属性が指定されたキャッシュ・グループの一部またはすべてがOracle Databaseサーバーと再同期化中です。少なくとも1つのキャッシュ・グループの状態がrecoveringです。

cgStatus

VARCHAR2(20)

指定されたキャッシュ・グループの自動リフレッシュの状態を指定します。次のいずれかの状態になります。
ok: 指定されたキャッシュ・グループはOracle Databaseと同期化されています。キャッシュ・エージェントは、Oracle Databaseサーバーに繋がっています。

dead - キャッシュ・エージェントはタイムアウト時間内にOracle Databaseに接続できず、指定されたキャッシュ・グループはOracle Databaseサーバーと同期していない可能性があります。

recovering: 指定されたキャッシュ・グループはOracle Databaseサーバーと再同期化中です。

例

次の例は、データベースの自動リフレッシュの状態がaliveであることを示しています。キャッシュ・グループの自動リフレッシュの状態はokです。

CALL ttCacheDbCgStatus ('terry', 'cgemployees');
< alive, ok >
1 row found.

データベースの自動リフレッシュの状態を確認するには、パラメータを指定せずにttCacheDbCgStatusをコールします。

CALL ttCacheDbCgStatus;
< dead, <NULL> >
1 row found.

注意

このプロシージャは、TimesTen Cacheでのみ使用可能です。

関連項目

ttCacheConfig
ttCachePolicyGet
ttCachePolicySet
ttCacheStart
ttCacheStop
ttCacheUidGet
ttCacheUidPwdSet
「ttAdmin」

ttCacheDDLTrackingConfig

このプロシージャは、キャッシュされたOracle Database表に対して発行されたDDL文の追跡を有効または無効にします。デフォルトでは、DDL文は追跡されません。

DDL追跡では、キャッシュされたすべてのOracle Database表の変更履歴が保存されます。DDL追跡表が1つ作成され、キャッシュされた任意のOracle Database表に対して発行されたDDL文が格納されます。この情報を使用して自動リフレッシュの問題を診断できます。

『Oracle TimesTen Application-Tier Database Cacheユーザーズ・ガイド』のキャッシュされたOracle Database表に対して発行されたDDL文の追跡に関する説明を参照してください。

必要な権限

このプロシージャには、CACHE_MANAGER権限が必要です。

構文

ttCacheDDLTrackingConfig('trackingStatus')

パラメータ

ttCacheDDLTrackingConfigには、次のパラメータがあります。

パラメータ

データ型

説明

trackingStatus

TT_VARCHAR(10)

キャッシュされたOracle Database表に対して発行されたDDL文を追跡するかどうかを指定します。有効な値は、次のとおりです。
enable - 追跡を有効にします。

disable(デフォルト): 追跡を無効にします。

結果セット

ttCacheDDLTrackingConfigは結果を返しません。

例

Command> CALL ttCacheDDLTrackingConfig('enable');

ttCachePolicyGet

説明

このプロシージャは、接続されたデータベースに対してTimesTenキャッシュ・エージェントを実行するタイミングを決定する現在のポリシーを返します。ポリシーは、alwaysまたはmanualのいずれかです。

必要な権限

このプロシージャには、権限は必要ありません。

構文

ttCachePolicyGet()

パラメータ

ttCachePolicyGetにパラメータはありません。

結果セット

ttCachePolicyGetは次の結果を返します。

列

データ型

値

cachePolicy

TT_VARCHAR(10)

データベースに対してTimesTenキャッシュ・エージェントを実行するタイミングを決定するために使用するポリシーを指定します。有効な値は、次のとおりです。
always: エージェントはデータベースに対して常時実行されます。このオプションは、TimesTenキャッシュ・エージェントをただちに起動します。TimesTenデーモンが再起動されると、自動的にキャッシュ・エージェントが再起動されます。

manual(デフォルト): ttCacheStart組込みプロシージャまたはttAdmin -cacheStartコマンドのいずれかを使用して、キャッシュ・エージェントを手動で起動する必要があります。ttCacheStop組込みプロシージャまたはttAdmin -cacheStopコマンドのいずれかを使用して、キャッシュ・エージェントを明示的に停止する必要があります。

例

TimesTenキャッシュ・エージェントの現在のポリシーを取得するには、次のように実行します。

CALL ttCachePolicyGet ();

注意

このプロシージャは、TimesTen Cacheでのみ使用可能です。

関連項目

ttCacheConfig
ttCacheDbCgStatus
ttCachePolicySet
ttCacheStart
ttCacheStop
ttCacheUidGet
ttCacheUidPwdSet
「ttAdmin」

ttCachePolicySet

説明

このプロシージャは、接続されたデータベースに対してTimesTenキャッシュ・エージェントを実行するタイミングを決定するポリシーを定義します。ポリシーは、alwaysまたはmanualのいずれかです。

必要な権限

このプロシージャには、CACHE_MANAGER権限が必要です。

構文

ttCachePolicySet('cachePolicy')

パラメータ

ttCachePolicySetには、次のパラメータがあります。

パラメータ

データ型

説明

cachePolicy

TT_VARCHAR(10)
NOT NULL

データベースに対してTimesTenキャッシュ・エージェントを実行するタイミングを決定するために使用するポリシーを指定します。有効な値は、次のとおりです。
always: エージェントはデータベースに対して常時実行されます。このオプションは、TimesTenキャッシュ・エージェントをただちに起動します。TimesTenデーモンが再起動されると、自動的にキャッシュ・エージェントが再起動されます。

manual(デフォルト): ttCacheStart組込みプロシージャまたはttAdmin -cacheStartコマンドのいずれかを使用して、キャッシュ・エージェントを手動で起動する必要があります。ttCacheStop組込みプロシージャまたはttAdmin -cacheStopコマンドのいずれかを使用して、キャッシュ・エージェントを明示的に停止する必要があります。

norestart: エラーが発生した後、データベースに対するキャッシュ・エージェントは再起動されません。

結果セット

ttCachePolicySetは結果を返しません。

例

TimesTenキャッシュ・エージェントのポリシーをalwaysに設定するには、次のように実行します。

CALL ttCachePolicySet ('always');

注意

このプロシージャは、TimesTen Cacheでのみ使用可能です。

ポリシーをmanualからalwaysに変更することによって、相対パスを使用してデータベースに対してTimesTenキャッシュ・エージェントを起動しようとすると、TimesTenはTimesTen Data Managerが起動している場所に対する相対パスでデータベースを検索し、失敗します。たとえば、Windows上でデータベースのパスにDataStore=./payrollを指定し、この組込みプロシージャでTimesTenキャッシュ・エージェントを起動しようとしても、TimesTen Data Managerはデータベースをinstall_dir\srvディレクトリで検索するため、起動しません。UNIXの場合は、/var/TimesTen/instanceディレクトリを検索します。

ポリシーの設定をalwaysに設定すると、キャッシュ・エージェントが停止している場合は自動的に起動されます。

関連項目

ttCacheConfig
ttCacheDbCgStatus
ttCachePolicyGet
ttCacheStart
ttCacheStop
ttCacheUidGet
ttCacheUidPwdSet
「ttAdmin」

ttCachePropagateFlagSet

説明

このプロシージャを使用すると、Oracle Databaseに対する現在のトランザクションにおいてコミットされた更新(DML文の実行結果)の伝播を無効にできます。フラグをゼロに設定した後のDML文実行による更新は、バックエンドのOracle Databaseに伝播されることはありません。そのため、これらの更新はTimesTenデータベースにのみ存在します。その後、フラグをリセットすることでDML文の伝播を再度有効にできます。

必要な権限

このプロシージャには、CACHE_MANAGER権限が必要です。

構文

ttCachePropagateFlagSet(CommitsOn)

パラメータ

ttCachePropagateFlagSetには、次のパラメータがあります。

パラメータ

データ型

説明

CommitsOn

TT_INTEGERNOT NULL

0の場合、更新がOracle Databaseに送信されないようにするフラグを設定します。トランザクションが終了するまで、またはプロシージャが1に設定されるまで、このフラグの設定は変更されません。
1の場合、更新がOracle Databaseに送信されます。

結果セット

ttCachePropagateFlagSetは結果を返しません。

注意

このプロシージャは、TimesTen Cacheでのみ使用可能です。

1つのトランザクションの中でttCachePropagateFlagSetの値が複数回有効になった場合、トランザクションの一部のみがOracle Databaseに伝播されます。

ttCachePropagateFlagSetは、FLUSH、LOAD、REFRESHおよびUNLOADなどの他のキャッシュ・グループ処理のいずれかとして、アプリケーションが同じトランザクション内で使用できる唯一の組込みプロシージャです。

コミットまたはロールバックの後、伝播フラグはリセットされます。

このプロシージャを使用する場合、AutoCommitを無効にする必要があります。無効にしない場合は、プロシージャを呼び出した後でトランザクションが終了するため、Oracle Databaseへの伝播が再度有効になります。

例

この例では、autocommitを無効に設定して、コミットの後に伝播フラグが無効から有効に切り替わらないようにします。ttCachePropagateFlagSetを呼び出して伝播を無効にします。oratt.writetabのTimesTenキャッシュ・ディテール表に1行が挿入されます。その後、ttCachePropagateFlagSet組込みプロシージャを呼び出してフラグを1に設定することで、伝播は再度有効になります。

Command> set autocommit off;
Command> call ttCachePropagateFlagSet(0);
Command> INSERT INTO oratt.writetab VALUES (103, 'Agent');
1 row inserted.
Command> COMMIT;
Command> SELECT * FROM oratt.writetab;
< 100, Oracle >
< 101, TimesTen >
< 102, Cache >
< 103, Agent >
4 rows found.
Command> call ttCachePropagateFlagSet(1);

Oracle Databaseのすべての行を選択する場合、伝播が無効のときに挿入された行は、Oracleのoratt.writetab表にはありません。

Command> set passthrough 3;
Command> SELECT * FROM oratt.writetab;
< 100, Oracle >
< 101, TimesTen >
< 102, Cache >
3 rows found.

ttCacheSqlGet

説明

このプロシージャは、次のキャッシュ・グループのOracleオブジェクトをインストールまたは削除するOracle Database SQL文を生成します。

- 読取り専用キャッシュ・グループ

- 増分自動リフレッシュが指定されたユーザー管理キャッシュ・グループ

- 非同期ライトスルー(AWT)キャッシュ・グループ

このプロシージャは、キャッシュ・グループを作成しているユーザーにOracle Databaseに書き込むための適切な権限がない場合に有効です。そのため、Oracle DBAではこの組込みプロシージャによって生成されたスクリプトを使用してOracle Databaseオブジェクトを作成できます。

必要な権限

このプロシージャには、CACHE_MANAGER権限が必要です。

構文

ttCacheSqlGet('feature_name', 'cache_group_name', install_flag)

パラメータ

ttCacheSqlGetには、次のパラメータがあります。

パラメータ

データ型

説明

feature_name

TT_VARCHAR (100)

INCREMENTAL_AUTOREFRESHまたはASYNCHRONOUS_WRITETHROUGHに指定できます。

cache_group_name

TT_VARCHAR (100)

キャッシュ・グループの名前。非同期ライトスルー・キャッシュ・グループのオブジェクトをインストールする場合、または自動リフレッシュ・ユーザー・アカウント内のすべてのOracle Databaseオブジェクトを削除する場合には、NULLを指定します。

install_flag

TT_INTEGER NOT NULL

install_flagが1の場合、ttCacheSqlGetは、自動リフレッシュまたは非同期ライトスルーのOracle DatabaseオブジェクトをインストールするOracle SQLを返します。
install_flagが0の場合、ttCacheSqlGetは、すでに作成されているオブジェクトを削除するSQLを返します。

結果セット

ttCacheSqlGetは次の結果セットを返します。

列

データ型

説明

retval

TT_VARCHAR (4096) NOT NULL

自動リフレッシュまたは非同期ライトスルーのOracle Databaseオブジェクトをインストールまたは削除するOracle SQL文。

continueFlag

TT_SMALLINT NOT NULL

結果列retvalのOracle SQL文が4096バイトを超え、次の結果行に続ける必要がある場合のみ、0(ゼロ)以外の値になります。

例

CALL ttCacheSqlGet('INCREMENTAL_AUTOREFRESH', 'westernCustomers', 1);

自動リフレッシュ・ユーザー・アカウントのすべてのOracle Databaseオブジェクトを削除するには、次のコマンドを使用します。

CALL ttCacheSqlGet('INCREMENTAL_AUTOREFRESH', NULL, 0);

注意

このプロシージャは、TimesTen Cacheでのみ使用可能です。

返された各retvalフィールドには、Oracle Databaseで直接実行される別々のOracle SQL文が含まれます。continueFlagフィールドで示されるように、1つの行は文の途中で終わっている場合があります。この場合、使用可能なSQL文を生成するために、前の行と連結する必要があります。

このプロシージャのスクリプト出力は、OracleのSQL*Plusユーティリティと互換性がありません。ただし、ttIsql cachesqlgetコマンドを使用すると、SQL*Plusユーティリティと互換性のあるスクリプトを生成できます。

cache_group_nameオプションに対してNULLを指定すると、ttDestroyユーティリティによってデータベースが破棄された後でOracle DatabaseオブジェクトをクリーンアップするOracle SQLを生成できます。

ttCacheStart

説明

このプロシージャは、接続しているデータベースに対してTimesTenキャッシュ・エージェントを起動します。

必要な権限

このプロシージャには、CACHE_MANAGER権限が必要です。

構文

ttCacheStart()

パラメータ

ttCacheStartにパラメータはありません。

結果セット

ttCacheStartは結果を返しません。

例

TimesTenキャッシュ・エージェントを起動するには、次のように実行します。

CALL ttCacheStart ();

注意

このプロシージャは、TimesTen Cacheでのみ使用可能です。

データベースに自動リフレッシュ・キャッシュ・グループまたは非同期ライトスルー・キャッシュ・グループがある場合、またはある可能性がある場合は、キャッシュ管理ユーザーIDおよびパスワードをttCacheUidPwdSet組込みプロシージャで設定してから、キャッシュ・エージェントを起動する必要があります。

ポリシーをmanualからalwaysに変更することによって、相対パスを使用してデータベースに対してTimesTenキャッシュ・エージェントを起動しようとすると、TimesTenはTimesTen Data Managerが起動している場所に対する相対パスでデータベースを検索し、失敗します。たとえば、Windows上でデータベースのパスにDataStore=./payrollを指定し、この組込みプロシージャでTimesTenキャッシュ・エージェントを起動しようとしても、TimesTen Data Managerはデータベースを\srvディレクトリで検索するため、起動しません。UNIXの場合は、/var/TimesTen/instanceディレクトリを検索します。

このプロシージャを使用する場合、コールを実行するアプリケーションを含めたすべてのアプリケーションは、データベース・レベルのロック(LockLevel=1)を指定する接続を保持することができません。

関連項目

ttCacheConfig
ttCacheDbCgStatus
ttCachePolicyGet
ttCachePolicySet
ttCacheStop
ttCacheUidPwdSet
ttCacheUidGet
「ttAdmin」

ttCacheStop

説明

このプロシージャは、接続しているデータベースに対してTimesTenキャッシュ・エージェントを停止します。

必要な権限

このプロシージャには、CACHE_MANAGER権限が必要です。

構文

ttCacheStop(timeout)

パラメータ

ttCacheStopには、次のパラメータがあります。

パラメータ

データ型

説明

timeout

TT_INTEGER

timeout秒数内にキャッシュ・エージェントが停止しない場合は、TimesTenデーモンに停止するように指定します。0を設定すると、デーモンはキャッシュ・エージェントを無期限待機します。デフォルト値は100です。

結果セット

ttCacheStopは結果を返しません。

例

TimesTenキャッシュ・エージェントを停止するには、次のように実行します。

CALL ttCacheStop();

注意

このプロシージャは、TimesTen Cacheでのみ使用可能です。

キャッシュ・グループを削除または変更した直後にキャッシュ・エージェントを停止しないでください。かわりに、少なくとも2分間待機します。待機しないと、キャッシュ・エージェントは、AUTOREFRESH機能で使用されたOracle Databaseオブジェクトをクリーンアップすることができません。

このプロシージャを使用する場合、コールを実行するアプリケーションを含めたすべてのアプリケーションは、データベース・レベルのロック(LockLevel=1)を指定する接続を保持することができません。

関連項目

ttCachePolicySet
ttCacheStart
ttCacheUidPwdSet
ttCacheUidGet
「ttAdmin」

ttCacheUidGet

説明

このプロシージャは、データベースのキャッシュ管理ユーザーIDを返します。キャッシュ管理ユーザーIDおよびパスワードがttCacheUidPwdSet組込みプロシージャを使用してデータベースに設定されていない場合、ttCacheUidGetはNULLを返します。

必要な権限

このプロシージャには、CACHE_MANAGER権限が必要です。

構文

ttCacheUidGet()

パラメータ

ttCacheUidGetにパラメータはありません。

結果セット

ttCacheUidGetは次の結果を返します。

列

データ型

説明

UID

TT_VARCHAR (30)

自動リフレッシュ・キャッシュ・グループおよび非同期ライトスルー・キャッシュ・グループで使用される、現在のキャッシュ管理ユーザーID。

例

CALL ttCacheUidGet();

注意

このプロシージャは、TimesTen Cacheでのみ使用可能です。

関連項目

ttCacheUidPwdSet
「ttAdmin」

ttCacheUidPwdSet

説明

キャッシュ管理ユーザーIDおよびパスワードを設定します。新しいデータベースごとにキャッシュ管理ユーザーIDおよびパスワードを1回だけ指定します。キャッシュ管理パスワードはいつでも変更できます。

必要な権限

このプロシージャには、CACHE_MANAGER権限が必要です。

構文

ttCacheUidPwdSet('UID', 'PWD')

パラメータ

ttCacheUidPwdSetには、次のパラメータがあります。

パラメータ

データ型

説明

UID

TT_VARCHAR (30)

自動リフレッシュ・キャッシュ・グループおよび非同期ライトスルー・キャッシュ・グループで使用される、キャッシュ管理ユーザーID。

PWD

TT_VARCHAR (30)

キャッシュ管理ユーザーのパスワード。

結果セット

ttCacheUidPwdSetは結果を返しません。

例

CALL ttCacheUidPwdSet('myid', 'mypwd');

注意

このプロシージャは、クライアント/サーバー接続からコールできません。

このプロシージャは、TimesTen Cacheでのみ使用可能です。

DDLReplicationLevelのすべてのレベルにおいて、キャッシュ・エージェントまたはレプリケーション・エージェントが実行されている場合は、キャッシュ管理ユーザーIDおよびパスワードを設定できます。キャッシュ管理ユーザーIDまたはパスワードの変更の詳細は、『Oracle TimesTen Application-Tier Database Cacheユーザーズ・ガイド』のキャッシュ・ユーザーの名前およびパスワードの変更に関する説明を参照してください。

キャッシュ管理ユーザーIDは、データベースにキャッシュ・グループがある間はリセットできません。キャッシュ管理パスワードはいつでも変更できます。

関連項目

ttCacheUidGet
ttCacheUidPwdSet
「ttAdmin」

ttCkpt

説明

このプロシージャは、非ブロッキング・チェックポイント処理を実行します。ブロッキング・チェックポイントの詳細は、「ttCkptBlocking」を参照してください。チェックポイント処理は、データベースの現在の状態をディスクに記録し、トランザクション・ログ・ファイルを削除するために行われます。非ブロッキング・チェックポイントでは、データベースに対するロックは必要ありません。

アプリケーションでは、バックグラウンド・チェックポイント属性(CkptFrequencyおよびCkptLogVolume)を設定するか、このプロシージャを明示的にコールし、データベースに対して定期的にチェックポイントを実行する必要があります。このプロシージャは、データベースで実行されている他のどのアプリケーションに対しても、非同期でコールすることができます。

デフォルトで、TimesTenはバックグラウンド・チェックポイントを一定間隔で実行します。

バックアップの実行中にアプリケーションがチェックポイント処理を実行しようとした場合、実行中のバックアップは、チェックポイント処理が終了するまで待機します。チェックポイント処理が、バックグラウンド・チェックポイント、またはアプリケーションで要求されたチェックポイントのどちらの場合でも、次のように処理されます。

- バックアップまたはチェックポイント処理の実行中に、ユーザーがバックアップを実行しようとした場合は、実行中のバックアップまたはチェックポイント処理の終了を待ちます。

- バックアップまたはチェックポイント処理の実行中に、チェックポイント処理を実行しようとした場合は、実行中の処理が終了するまで待機しません。すぐにエラーを返します。

バックグラウンド・チェックポイントを無効にするには、CkptFrequency=0およびCkptLogVolume=0を設定します。

データベースに障害が発生したとき、ディスク上のチェックポイントが非ブロッキング・チェックポイントだった場合、TimesTenはログ・ファイルを使用してリカバリを行います。

必要な権限

このプロシージャには、ADMIN権限が必要です。

構文

ttCkpt([timeout], [retries])

パラメータ

ttCkptには、次のオプションのパラメータがあります。

パラメータ

データ型

説明

timeout

TT_INTEGER

ttCkptがタイムアウトする前にデータベース・ロックを取得するために待機する時間(秒)。timeoutの値は0から1,000,000です。指定しない場合、チェックポイントのタイムアウトは発生しません。

retries

TT_INTEGER

タイムアウトが発生した場合にttCkptがデータベース・ロックを取得しようとする回数。retriesの値は0から10です。指定しない場合、デフォルトは0です。

結果セット

ttCkptは結果を返しません。

例

CALL ttCkpt();

注意

チェックポイントの詳細は、『Oracle TimesTen In-Memory Databaseオペレーション・ガイド』のトランザクション管理に関する説明を参照してください。

関連項目

ttCkptBlocking
ttCkptConfig
ttCkptHistory

ttCkptBlocking

説明

このプロシージャは、ブロッキング・チェックポイント処理を実行します。チェックポイント処理は、データベースの現在の状態をディスクに記録し、トランザクション・ログ・ファイルを削除するために行われます。このチェックポイントでは、データベースへの排他アクセスを必要とするため、チェックポイントの実行中は他のアプリケーションがデータベースからブロックされる可能性があります。

このプロシージャが呼び出されると、現行のトランザクションがコミットまたはロールバックされたときに、TimesTenはブロッキング・チェックポイントを実行します。その時点で他のトランザクションが進行中であれば、チェックポイントを実行する接続は、他のトランザクションがコミットまたはロールバックされるまで待機します。チェックポイント接続の待機中は、起動する他の新しいトランザクションは、チェックポイントを実行しているトランザクションの後のキューに入ります。その結果、長時間実行するトランザクションがあると、他の多数のトランザクションを待機させることとなります。したがって、このブロッキング・チェックポイントは注意して使用してください。非ブロッキング・チェックポイントを実行するには、ttCkptプロシージャを使用します。

ブロッキング・チェックポイントを使用している場合、ログ・ファイルは必要ありません。ログが存在する場合、TimesTenではリカバリ後にそのログを使用してデータベースが最新状態になります。

必要な権限

このプロシージャには、ADMIN権限が必要です。

構文

ttCkptBlocking([timeout], [retries])

パラメータ

ttCkptBlockingには、次のオプションのパラメータがあります。

パラメータ

データ型

説明

timeout

TT_INTEGER

ttCkptBlockingがタイムアウトする前にデータベース・ロックを取得するために待機する時間(秒)。timeoutの値は0から1,000,000です。指定しない場合、チェックポイントのタイムアウトは発生しません。

retries

TT_INTEGER

タイムアウトが発生した場合にttCkptBlockingがデータベース・ロックを取得しようとする回数。retriesの値は0から10です。指定しない場合、デフォルトは0です。

結果セット

ttCkptBlockingは結果を返しません。

例

CALL ttCkptBlocking();
CALL ttCkptBlocking(1,10);

注意

このチェックポイントはコミットまたはロールバック時に実行されるため、ttCkptBlockingの呼出しは常に成功します。コミットまたはロールバックの実行時に、チェックポイント処理についての問題(ディスク領域の不足やタイムアウト)が発生すると、アプリケーションに警告が返されます。チェックポイントに問題があるコミットやロールバックは、チェックポイントが失敗したとしても成功するため、チェックポイントの問題はエラーとして扱われません。ODBCでは、リターン・コードSQL_SUCCESS_WITH_INFOを伴って警告が返されます。

チェックポイントの詳細は、『Oracle TimesTen In-Memory Databaseオペレーション・ガイド』のトランザクション管理に関する説明を参照してください。

関連項目

ttCkpt
ttCkptConfig
ttCkptHistory

ttCkptConfig

説明

このプロシージャは、バックグラウンド・チェックポイント処理を動的に再構成したり、構成パラメータの現在アクティブな設定を返します。ttCkptConfigを使用して加えられた変更は、ただちに有効になります。したがって、ckptRateの変更は現在処理中のチェックポイントに影響します。

ttCkptConfigを使用してバックグラウンド・チェックポイント処理に加えられた変更は永続的です。DSNまたは接続文字列でCkptFrequencyおよびCkptLogVolume接続属性が指定されないかぎり、その後のデータベースのロードでは、変更された設定が使用されます(属性の指定があった場合は、その値が使用されます)。

必要な権限

このプロシージャには、現在の値を問い合せるための権限は必要ありません。現在の値を変更するには、ADMIN権限が必要です。

構文

ttCkptConfig(ckptFrequency, ckptLogVolume, ckptRate)

パラメータ

ttCkptConfigには、次のパラメータがあります。

パラメータ

データ型

説明

ckptFrequency

TT_INTEGER

チェックポイント頻度(秒)。0からMAXINTの値を指定できます。0の値は、チェックポイントのスケジュール時にチェックポイント頻度が考慮されないことを意味します。

ckptLogVolume

TT_INTEGER

チェックポイント間のログ・ボリューム(MB)。0からMAXINTの値を指定できます。0の値は、チェックポイントのスケジュール時にチェックポイント・ログ・ボリュームが考慮されないことを意味します。

ckptRate

TT_INTEGER

チェックポイントをディスクに書き込む速度をMB/秒単位で指定します。
0は、速度を制限しないことを意味し、NULLは、速度を変更せずそのままにしておくことを意味します。このパラメータを変更すると、現在実行中のチェックポイント処理にも影響します。

結果セット

ttCkptConfigは次の結果を返します。

列

データ型

説明

ckptFrequency

TT_INTEGERNOT NULL

チェックポイント頻度の現在アクティブな設定(秒)。

ckptLogVolume

TT_INTEGERNOT NULL

チェックポイント間のログ・ボリュームの現在アクティブな設定(MB)。

ckptRate

TT_INTEGERNOT NULL

TimesTenにおいてチェックポイントがディスクに書き込まれる現在の速度。

例

バックグラウンド・チェックポイント構成パラメータの現在の設定を表示するには、次のように実行します。

CALL ttCkptConfig;
< 600, 32, 0 >
1 row found.

ログが制限に到達しないかぎり、チェックポイントの開始からバックグラウンド・チェックポイント処理を停止するには、次のように実行します。

CALL ttCkptConfig(0);
< 0, 32, 0 >
1 row found.

チェックポイントの開始からバックグラウンド・チェックポイント処理を停止するには、次のように実行します。

CALL ttCkptConfig(0, 0);
< 0, 0, 0 >
1 row found.

600秒ごとにチェックポイントを実行するか、ログが32MBに到達したときにチェックポイントを実行する(先に実行される方)ようにバックグラウンド・チェックポイント構成を設定するには、次のように実行します。

CALL ttCkptConfig(600, 32);
< 600, 32, 0 >
1 row found.

注意

デフォルトで、TimesTenはバックグラウンド・チェックポイントを一定間隔で実行します。

バックアップの実行中にアプリケーションがチェックポイント処理を実行しようとした場合、実行中のバックアップは、チェックポイント処理が終了するまで待機します。チェックポイント処理が、バックグラウンド・チェックポイント、またはアプリケーションで要求されたチェックポイントのどちらの場合でも、次のように処理されます。

- バックアップまたはチェックポイント処理の実行中に、ユーザーがバックアップを実行しようとした場合は、実行中のバックアップまたはチェックポイント処理の終了を待ちます。

- バックアップまたはチェックポイント処理の実行中に、チェックポイント処理を実行しようとした場合は、実行中の処理が終了するまで待機しません。すぐにエラーを返します。

バックグラウンド・チェックポイントを無効にするには、CkptFrequency=0およびCkptLogVolume=0を設定します。

関連項目

CkptFrequency
CkptLogVolume
ttCkpt
ttCkptHistory

ttCkptHistory

説明

このプロシージャは、最後に実行された8つのチェックポイントに関する情報を返します(チェックポイント、エージェントの種類は問いません)。

必要な権限

このプロシージャには、権限は必要ありません。

構文

ttCkptHistory( )

パラメータ

ttCkptHistoryにパラメータはありません。

結果セット

ttCkptHistoryは次の結果セットを返します。

列

データ型

説明

startTime

TT_TIMESTAMP NOT NULL

チェックポイントが開始された時間。

endTime

TT_TIMESTAMP

チェックポイントが完了した時間。

type

TT_CHAR(16) NOT NULL

実行されたチェックポイントのタイプ。次のいずれかの値です。
Static: データベースの作成時および最後の切断時に自動的に実行されるチェックポイント。

Blocking - トランザクション一貫性チェックポイント。

Fuzzy - 非ブロッキング・チェックポイント。可能な場合、バックグラウンド・チェックポイント処理はこのタイプのチェックポイントを実行します。

None: チェックポイント・ファイルのない一時データベースの場合。

status

TT_CHAR(16) NOT NULL

チェックポイント処理の結果のステータス。次のいずれかの値です。
In Progress: チェックポイントは現在処理中です。最新の結果行のみがこのステータスになります。

Completed: チェックポイントは正常に完了しました。

Failed: チェックポイントは失敗しました。最新の結果行のみがこのステータスになります。この場合、error列に、失敗の理由が示されます。

initiator

TT_CHAR(16) NOT NULL

チェックポイント・リクエストのソース。次のいずれかの値です。
User: ユーザーレベルのアプリケーション。このようなアプリケーションには、ttIsqlのようなTimesTenユーティリティがあります。

Checkpointer: バックグラウンド・チェックポイント処理。

Subdaemon: データベースの管理用サブデーモン。共有データベースでは、最後の切断チェックポイントはサブデーモンによって実行されます。

error

TT_INTEGER

チェックポイントが失敗した場合、この列に失敗の理由が示されます。値は、TimesTenエラー番号のいずれかです。

ckptFileNum

TT_INTEGERNOT NULL

チェックポイントで使用されるデータベース・ファイル番号。このファイル番号は、チェックポイント・ファイル拡張子datastore.ds0またはdatastore.ds1の番号に対応しています。

ckptLFN

TT_INTEGER

チェックポイント・ログ・レコードのトランザクション・ログ・ファイル番号。

ckptLFO

TT_BIGINT

チェックポイント・ログ・レコードのトランザクション・ログ・ファイル・オフセット。

blksTotal

TT_BIGINT

現在データベースに割り当てられている永続ブロック数。これらのブロックは、チェックポイントの実行対象となります。

bytesTotal

TT_BIGINT

blksTotalによって占有されるバイト数。

blksInUse

TT_BIGINT

blksTotalのうち、現在使用中のブロック数。

bytesInUse

TT_BIGINT

blksInUseによって占有されるバイト数。

blksDirty

TT_BIGINT

このチェックポイントによって書き込まれた使用済ブロック数。

bytesDirty

TT_BIGINT

blksDirtyによって占有されるバイト数。

bytesWritten

TT_BIGINT

このチェックポイントによって書き込まれた合計バイト数。

Percent_Complete

TT_INTEGER

処理中のチェックポイントがある場合に、完了したチェックポイントの割合を示します。処理中のチェックポイントがない場合の値はNULLです。戻り値は、直前に書き込まれたブロックのブロックIDとデータベースのPermSizeを比較して計算されます。この値は、必ずしもチェックポイントの完了に必要な残り時間を正確に表すものではありませんが、ディスク書込みに必要な残り時間の目安にはなります。このフィールドには、使用済ブロックの書込みの進捗状況のみが表示され、チェックポイントの最後に追加のブックキーピングは含まれません。チェックポイントの処理中にこのプロシージャをコールすると、値はNULL以外になります。

ckptVNo

TT_INTEGERNOT NULL

チェックポイントごとに増加するチェックポイント順序番号。

例

処理中のチェックポイントの例を次に示します。

Call ttckpthistory;
< 2011-04-14 16:56:34.169520, <NULL>, Fuzzy           ,
In Progress     , User
, <NULL>, 0, <NULL>, <NULL>, <NULL>, <NULL>, <NULL>, <NULL>,
<NULL>, <NULL>, <NULL>, 13, 6 >

< 2011-04-14 16:55:47.703199, 2011-04-14 16:55:48.188764,
Fuzzy           , Completed       , Checkpointer    , <NULL>,
1, 0, 8964304, 294, 33554432, 291, 5677288, 27, 1019512,
1065408, <NULL>, 5 >

< 2011-04-14 16:54:47.106110, 2011-04-14 16:54:47.723379,
Static          , Completed       , Subdaemon       , <NULL>,
0, 0, 8960328, 294, 33554432, 291, 5677288, 256, 33157172,
5321548, <NULL>, 4 >

< 2011-04-14 16:54:41.633792, 2011-04-14 16:54:42.568469,
Blocking        , Completed       , User            , <NULL>,
1, 0, 8958160, 294, 33554432, 291, 5677288, 31, 1162112,
6604976, <NULL>, 3 >

< 2011-04-14 16:54:37.438827, 2011-04-14 16:54:37.977301,
Static          , Completed       , User            , <NULL>,
0, 0, 1611984, 93, 33554432, 92, 1853848, 93, 33554432,
1854052, <NULL>, 2 >

< 2011-04-14 16:54:36.861728, 2011-04-14 16:54:37.438376,
Static          , Completed       , User            , <NULL>,
1, 0, 1609936, 93, 33554432, 92, 1853848, 93, 33554432,
1854052, <NULL>, 1 >

6 rows found.

最新のチェックポイントの試行中に発生したエラーの例を次に示します。

call ttckpthistory;
< 2011-04-14 16:57:14.476860, 2011-04-14 16:57:14.477957,
Fuzzy           , Failed , User            , 847, 1, <NULL>,
<NULL>, 0, 0, 0, 0, 0, 0, 0, <NULL>, 7 >

< 2011-04-14 16:56:34.169520, 2011-04-14 16:56:59.715451,
Fuzzy           , Completed       , User            , <NULL>,
0, 0, 8966472, 294, 33554432, 291, 5677288, 5, 522000,
532928, <NULL>, 6 >

< 2011-04-14 16:55:47.703199, 2011-04-14 16:55:48.188764,
Fuzzy           , Completed       , Checkpointer    , <NULL>,
1, 0, 8964304, 294, 33554432, 291, 5677288, 27, 1019512,
1065408, <NULL>, 5 >

< 2011-04-14 16:54:47.106110, 2011-04-14 16:54:47.723379,
Static          , Completed       , Subdaemon       , <NULL>,
0, 0, 8960328, 294, 33554432, 291, 5677288, 256, 33157172,
5321548, <NULL>, 4 >

< 2011-04-14 16:54:41.633792, 2011-04-14 16:54:42.568469,
Blocking        , Completed       , User            , <NULL>,
1, 0, 8958160, 294, 33554432, 291, 5677288, 31, 1162112,
6604976, <NULL>, 3 >

< 2011-04-14 16:54:37.438827, 2011-04-14 16:54:37.977301,
Static          , Completed       , User            , <NULL>,
0, 0, 1611984, 93, 33554432, 92, 1853848, 93, 33554432,
1854052, <NULL>, 2 >

< 2011-04-14 16:54:36.861728, 2011-04-14 16:54:37.438376,
Static          , Completed       , User            , <NULL>,
1, 0, 1609936, 93, 33554432, 92, 1853848, 93, 33554432,
1854052, <NULL>, 1 >

7 rows found.

注意

結果は、開始時間が新しいものから順に表示されます。

失敗した行は、次のチェックポイントによって上書きされます。

関連項目

ttCkpt
ttCkptBlocking

ttCommitBufferStats

説明

この組込みプロシージャは、コミット・バッファのオーバーフロー回数、およびトランザクション・コミット処理の間にトランザクション再利用レコードに使用された最大メモリー量を返します。

このプロシージャ・コールの結果によって提供される情報は、CommitBufferSizeMax接続属性またはALTER SESSION SQL文(『Oracle TimesTen In-Memory Database SQLリファレンス』を参照)を使用してコミット・バッファの最大サイズを明示的に設定する場合に役立ちます。このプロシージャにより、オーバーフローの回数および再利用レコードによる最大メモリー使用量に基づいて、再利用バッファの正しいサイズを選択できるようになります。

バッファ・オーバーフローがある場合には、コミット・バッファの最大サイズを増やすことを検討します。バッファ・オーバーフローがなく、最大メモリー使用量がコミット・バッファの最大サイズを十分に下回っている場合には、コミット・バッファの最大サイズを減らすことを検討します。

コミット・バッファ・サイズの設定方法を含む再利用操作の詳細は、『Oracle TimesTen In-Memory Databaseオペレーション・ガイド』のトランザクション再利用操作に関する説明を参照してください。

必要な権限

このプロシージャには、権限は必要ありません。

構文

ttCommitBufferStats( )

パラメータ

ttCommitBufferStatsにパラメータはありません。

結果セット

ttCommitBufferStatsは次の結果を返します。

列

データ型

説明

overflows

TT_BIGINTNOT NULL

コミット・バッファ・オーバーフローの合計回数。

maxReached

TT_BIGINTNOT NULL

トランザクション・コミット・バッファに現在使用されている最大量(バイト)。

例

次の例は、コミット・バッファ・オーバーフローがなく、トランザクション・コミット・バッファが500MBに設定されているセッションの結果を示しています。

Command> ALTER SESSION SET COMMIT_BUFFER_SIZE_MAX = 500;
Session altered.
Command> CALL ttCommitBufferStats( );
< 0, 524288000 >
1 row found

コミット・バッファ・オーバーフローが10回あり、トランザクション・コミット・バッファが2MBに設定されているセッションでは、このプロシージャの出力は次のようになります。

Command> ALTER SESSION SET COMMIT_BUFFER_SIZE_MAX = 2;
Session altered.
Command> CALL ttCommitBufferStats( );
< 0, 2097152 >
1 row found

注意

組込みプロシージャttCommitBufferStatsResetをコールすると、コミット・バッファ統計はバイトで表されます。ただし、ttConfigurationの出力および接続属性CommitBufferSizeMaxによって設定された値はMBで表されます。

関連項目

ttCommitBufferStatsReset

ttCommitBufferStatsReset

説明

ttCommitBufferStatsResetプロシージャは、トランザクション・コミット・バッファ統計を0にリセットします。これはたとえば、コミット・バッファの最大サイズに新しい値を設定し、統計を再開する場合に役立ちます。

コミット・バッファ・サイズの設定方法を含む再利用操作の詳細は、『Oracle TimesTen In-Memory Databaseオペレーション・ガイド』のトランザクション再利用操作に関する説明を参照してください。

必要な権限

このプロシージャには、権限は必要ありません。

構文

ttCommitBufferStatsReset()

パラメータ

ttCommitBufferStatsResetにパラメータはありません。

結果セット

ttCommitBufferStatsResetは結果セットを返しません。

例

CALL ttCommitBufferStatsReset;

関連項目

ttCommitBufferStats

ttCompact

説明

このプロシージャは、データベースの永続データ・パーティションと一時データ・パーティションの両方を圧縮します。

ttCompactは、空き領域の隣接しているブロックをマージしますが、割り当てられているデータ項目の移動は行いません。したがって、割当済のメモリーのブロックで囲まれている、未割当ての小さなブロックによって発生する断片化は、ttCompactを使用しても排除されません。

このプロシージャは、下位互換用にサポートされています。新しいアプリケーションではコールしません。

必要な権限

このプロシージャには、ADMIN権限が必要です。

構文

ttCompact()

パラメータ

ttCompactにパラメータはありません。

結果セット

ttCompactは結果を返しません。

例

CALL ttCompact;

注意

データを圧縮しても、結果のアドレスは変更されません。

関連項目

ttCompactTS

ttCompactTS

説明

このプロシージャはttCompactと似ていますが、ttCompactがデータベース全体を圧縮するのに対して、ttCompactTSはデータベースの小さな断片を圧縮するために使用します。ttCompactTSは、ttCompactを時間で区切ったものです。ttCompactTSは、データベース内のすべてのブロックについて、指定した分量の圧縮を繰り返します。圧縮が1回行われるごとに、MONITOR表のDS_COMPACTSフィールドの値が増加します。

このプロシージャは、下位互換用にサポートされています。新しいアプリケーションではコールしません。

必要な権限

このプロシージャには、ADMIN権限が必要です。

構文

ttCompactTS(quantum)

パラメータ

ttCompactTSには、次のパラメータがあります。

パラメータ

データ型

説明

quantum

TT_INTEGERNOT NULL

ttCompactTSが圧縮するデータ・ブロック数を指定する、0(ゼロ)以外の正の整数。1つのquantumは1つのデータ・ブロックに対応します。

結果セット

ttCompactTSは結果を返しません。

例

CALL ttCompactTS (5);

注意

データを圧縮しても、結果のアドレスは変更されません。

関連項目

ttCompact

ttComputeTabSizes

説明

ttComputeTabSizes組込みプロシージャは、TimesTenのシステム表に格納された表サイズの統計をリフレッシュします。この組込みプロシージャをコールした後で、DBA_TAB_SIZES、USER_TAB_SIZESまたはALL_TAB_SIZESの各ビューを問い合せると、統計の最新情報を確認できます。

このプロシージャは、表内の行を格納するために割り当てられている記憶域、表外バッファおよびシステムの使用量などの、指定された表に割り当てられている様々なタイプの記憶域を計算します。表を指定しない場合、このプロシージャは、そのユーザーがSELECT権限を持つすべての表のサイズを計算します。この組込みプロシージャを実行すると、DDL文と同様に、プロシージャの開始直後にトランザクションがコミットされ、処理が正常に完了すると再度コミットされます。

必要な権限

このプロシージャでは、指定した表に対するSELECT権限が必要です。

構文

ttComputeTabSizes (['tblName'], [includeOutOfLine])

パラメータ

ttComputeTabSizesには、次のパラメータがあります。

パラメータ

データ型

説明

tblName

TT_CHAR(61)

アプリケーション表の名前。表の所有者を含めることができます。NULL値または空の文字列を指定すると、現在のすべての表に対する統計が更新されます。
想定される表のタイプは次のとおりです。

- キャッシュ・グループ表を含む、ユーザー表

- マテリアライズド・ビュー

- システム表

includeOutOfLine

TT_INTEGER

0(no)または1(yes)。デフォルトは1(yes)です。
値が0(no)の場合、表外の列を持つ表について、表外の値のサイズは計算されません。表外のフィールドはNULLとして表示されます。

表外の値の計算を省くと、このプロシージャの待機時間が大幅に短縮されます。

結果セット

ttComputeTabSizesは結果を返しません。

例

表外の列を除いてmy_tableのサイズを計算するには、次のコマンドを使用します。

CALL ttComputeTabSizes ('my_table', 0);

注意

この組込みプロシージャでは、ttComputeTabSizesを実行しているときでも挿入操作が可能です。そのため、ttComputeTabSizesで計算される各表のサイズは、計算中の表の最小サイズと最大サイズの間で値が決まります。たとえば、ttComputeTabSizesの実行時に表のサイズが250MBの場合、同時に実行しているトランザクションによって表のサイズが300MBに増加すると、ttComputeTabSizesは250から300MBの間で値を推定します。

関連項目

ttSize

ttConfiguration

説明

ttConfiguration組込みプロシージャは、現在のデータベース接続のほとんど(すべてではない)の接続属性の値を返します。具体的には、ttConfiguration組込みプロシージャは、次の接続属性の値を返します。

CacheAwtMethod
CacheAwtParallelism
CacheGridEnable
CacheGridMsgWait
CkptFrequency
CkptLogVolume
CkptRate
CkptReadThreads
CommitBufferSizeMax
ConnectionCharacterSet
ConnectionName
Connections
DDLCommitBehavior
DDLReplicationAction
DDLReplicationLevel
DataBaseCharacterSet
DataStore
DynamicLoadEnable
DuplicateBindMode
DurableCommits
DynamicLoadErrorMode
Isolation
RangeIndexType
LockLevel
LockWait
LogAutoTruncate
LogBufMB
LogBufParallelism
LogDir
LogFileSize
LogFlushMethod
LogPurge
MemoryLock
NLS_LENGTH_SEMANTICS
NLS_NCHAR_CONV_EXCP
NLS_SORT
OracleNetServiceName
PLSCOPE_SETTINGS
PLSQL
PLSQL_CCFLAGS
PLSQL_CODE_TYPE
PLSQL_CONN_MEM_LIMIT
PLSQL_MEMORY_ADDRESS
PLSQL_MEMORY_SIZE
PLSQL_OPTIMIZE_LEVEL
PLSQL_TIMEOUT
PassThrough
PermSize
PermWarnThreshold
Preallocate
PrivateCommands
QueryThreshold
RACCallback
ReceiverThreads
RecoveryThreads
ReplicationApplyOrdering
ReplicationParallelism
ReplicationTrack
SQLQueryTimeout
TempSize
TempWarnThreshold
Temporary
TypeMode
UID

必要な権限

このプロシージャには、権限は必要ありません。

構文

ttConfiguration(['paramName'])

パラメータ

ttConfigurationには、次のオプションのパラメータがあります。

パラメータ

データ型

説明

paramName

TT_VARCHAR (30)

このプロシージャで値を返す接続属性の名前。

結果セット

ttConfigurationは次の結果セットを返します。

列

データ型

説明

paramName

TT_VARCHAR (30)
NOT NULL

接続文字列中に指定されている接続属性の名前。アルファベット順に返されます。

paramValue

TT_VARCHAR (1024)

接続文字列中に指定されている接続属性の値。

例

QueryThreshold接続属性の値を表示するには、次のコマンドを使用します。

CALL ttConfiguration('querythreshold');
<QueryThreshold, 0>
1 row found

すべての属性値を表示するには、次のコマンドを使用します。

CALL ttConfiguration();
< CacheGridEnable, 1 >
< CacheGridMsgWait, 60 >
< CkptFrequency, 600 >
< CkptLogVolume, 0 >
. . .

注意

クライアント・ドライバ属性の値は、このプロシージャでは返されません。

このプロシージャでは、ForceConnectなどの他の属性の値も返されません。

関連項目

第1章「接続属性」

ttContext

説明

このプロシージャは、現在の接続のコンテキスト値をBINARY(8)値として返します。コンテキストを使用して、ttStatusユーティリティおよびttDataStoreStatus組込みプロシージャによって提示される接続リストから、データベースに一意の接続を関連付けることができます。

必要な権限

このプロシージャには、権限は必要ありません。

構文

ttContext()

パラメータ

ttContextにパラメータはありません。

結果セット

ttContextは次の結果セットを返します。

列

データ型

説明

context

BINARY(8)

現在の接続のコンテキスト値。

例

CALL ttContext;

注意

コンテキスト値の番号は1つのプロセス内でのみ一意です。データベース全体では一意ではありません。したがって、異なるプロセスで同じコンテキスト値が使用されている可能性があります。

関連項目

ttDataStoreStatus
「ttStatus」

ttDataStoreStatus

説明

このプロシージャは、データベースに接続されたプロセスのリストを返します。dataStoreパラメータにNULLを指定すると、アクティブなすべてのデータベースの状態が返されます。

結果セットは、ttStatusユーティリティの出力と似ています。

必要な権限

このプロシージャには、権限は必要ありません。

構文

ttDataStoreStatus('dataStore')

パラメータ

ttDataStoreStatusには、次のパラメータがあります。

パラメータ

データ型

説明

dataStore

TT_VARCHAR (256)

特定のデータベースのフルパス名、またはすべてのデータベースの場合はNULL。

結果セット

ttDataStoreStatusは、次の結果セットを返します。

列

データ型

説明

dataStore

TT_VARCHAR (256) NOT NULL

データベースのフルパス名。

PID

TT_INTEGERNOT NULL

プロセスID。

Context

BINARY(8) NOT NULL

接続のコンテキスト値。

conType

TT_CHAR (16)
NOT NULL

接続しているプロセスのタイプ。結果は、次のいずれかです。
application: 通常のアプリケーションが接続されています。

replication: レプリケーション・エージェントが接続されています。

subdaemon: サブデーモンが接続されています。

oracleagent: キャッシュ・エージェントが接続されています。

ShmID

TT_VARCHAR (260)
NOT NULL

データベースが占有する共有メモリーIDの出力可能な形式。

connection_Name

TT_CHAR (30)
NOT NULL

データベース接続のシンボリック名。

connID

TT_INTEGERNOT NULL

データベース接続の数値ID。

例

CALL ttDataStoreStatus('/data/Purchasing');

関連項目

ttContext
「ttStatus」

ttDBConfig

説明

ttDBConfig組込みプロシージャを使用すると、ユーザーはTimesTenデータベース・システム・パラメータの値を設定または表示できます。

必要な権限

このプロシージャを実行するにはADMIN権限が必要です。

構文

ttDBConfig('param', 'value')

パラメータ

ttDBConfigには、次のパラメータがあります。

パラメータ

データ型

説明

param

VARCHAR2(30) NOT NULL

値を設定するまたは現在の値を確認する対象のシステム・パラメータ。この引数の許容値は次のとおりです。
CacheParAwtBatchSize

CacheAwtMethod

CacheAgentCommitBufSize

ParReplMaxDrift

RepAgentCommitBufSize

value

VARCHAR2(200)

システム・パラメータの値。
値を指定しない場合、このプロシージャは指定したパラメータの現在の値を返します。

パラメータ/値のペア

次の名前/値のペアが結果セットで返されます。

名前

値

説明

CacheParAwtBatchSize

バッチ内の行数

単一のバッチに含まれる行数に対するしきい値を設定します。最大の行数に達すると、TimesTenがトランザクションに残りの行を含めますが(TimesTenはトランザクションを解除しません)、バッチにそれ以上のトランザクションを追加しません。
注意: Oracle TimesTenテクニカル・サポートからのアドバイスがないかぎり、このパラメータの値は変更しないでください。

CacheAwtMethod

0: SQL配列実行メソッド
1: PL/SQL実行メソッド

Oracle Databaseサーバーに変更を適用するためのAWT伝播で、PL/SQL実行メソッドを使用するか、SQL配列実行メソッドを使用するかを指定します。
詳細は、「CacheAWTMethod」接続属性の説明を参照してください。

この組込みプロシージャで設定された場合、接続属性の値は無視されます。

CacheAgentCommitBufSize

MBで表されるサイズ

キャッシュ・エージェントに再利用バッファの最大サイズを指定します。キャッシュ・エージェントは値が変更されたかどうかを定期的に確認します。サイズは一時パーティションのサイズより大きくできません。
詳細は、『Oracle TimesTen Application-Tier Database Cacheユーザーズ・ガイド』の自動リフレッシュ処理時にメモリーを再利用する際のパフォーマンスの向上に関する説明を参照してください。

ParReplMaxDrift

秒数

パラレル・レプリケーションの追跡間で可能なドリフトの秒数を指定します。自動パラレル・レプリケーションを使用し、コミットの依存性を無効にすると、一部の追跡が他追跡の前に移動する場合があります。このしきい値を過ぎると、TimesTenは、すべてのレプリケーション追跡が互いに追いつくように、これらを同期化します。デフォルトでは、これはゼロに設定され、追跡間のドリフトのチェックは無効になっています。
詳細は、『Oracle TimesTen In-Memory Database開発者および管理者ガイド』のコミット依存性が無効化された自動パラレル・レプリケーションの構成に関する項を参照してください。

RepAgentCommitBufSize

MBで表されるサイズ

レプリケーション・エージェントに再利用バッファの最大サイズを指定します。レプリケーション・エージェントは値が変更されたかどうか定期的に確認します。サイズは一時パーティションのサイズより大きくできません。
詳細は、『Oracle TimesTen Application-Tier Database Cacheユーザーズ・ガイド』の自動リフレッシュ処理時にメモリーを再利用する際のパフォーマンスの向上に関する説明を参照してください。

結果セット

ttDBConfigは、次の結果セットを返します。

列

データ型

説明

param

VARCHAR2(30)

システム・パラメータの名前。

value

VARCHAR2(200)

指定されたパラメータの現在の値を表示します。

例

CacheParAwtBatchSizeの現在の値を取得するには次のように実行します。

CALL ttDBConfig('CacheParAwtBatchSize');
<CACHEPARAWTBATCHSIZE, 125>
1 row found.

RepAgentCommitBufSizeの値を50MBに設定するには、次のように実行します。

CALL ttDBConfig('RepAgentCommitBufSize', '50');
<REPAGENTCOMMITBUFSIZE, 50>
1 row found.

CacheAgentCommitBufSizeの現在の値を100に設定するには、次のように実行します。

Command> call ttDBConfig('CacheAgentCommitBufSize', '100');
< CACHEAGENTCOMMITBUFSIZE, 100 >
1 row found.

注意

この組込みプロシージャを使用してパラメータ値を設定した後には、チェックポイントを開始してパラメータ変更の永続性を確認してください。ttCheckpointプロシージャの詳細は、『Oracle TimesTen In-Memory Databaseオペレーション・ガイド』のチェックポイント処理に関する説明を参照してください。チェックポイントの組込みプロシージャの詳細は、この章の「ttCkpt」を参照してください。

ttDbConfigによるパラメータ値の変更はロールバックできません。

関連項目

「CacheAWTMethod」
『Oracle TimesTen Application-Tier Database Cacheユーザーズ・ガイド』のAWTのスループットの向上に関する説明、AWTキャッシュ・グループのパラレル伝播におけるバッチ・サイズの構成に関する説明および自動リフレッシュ処理時にメモリーを再利用する際のパフォーマンスの向上に関する説明

ttDbWriteConcurrencyModeGet

説明

ttDbWriteConcurrencyModeGet組込みプロシージャは、データベースの書込み同時実行モードおよび書込み同時実行モード処理とトランザクションの状態についての情報を返します。

必要な権限

このプロシージャには、権限は必要ありません。

構文

ttDbWriteConcurrencyModeGet()

パラメータ

ttDbWriteConcurrencyModeGetにはパラメータはありません。

結果セット

ttDbWriteConcurrencyModeGetは結果セットを返します。

列

データ型

説明

ts

TIMESTAMP NOT NULL

ステータス情報が収集された時刻。

mode

TT_INTEGER NOT NULL

書込み同時実行モード。
0: ヒントおよび標準的な最適化技術に従って最適化します。

1: 同時書込み処理を最適化します。

operation

VARCHAR2 (50)

書込み同時実行モードの移行状態。次のいずれかです。
NULL: 移行していません。

TRANSITIONING TO MODE=n (n= 0または1)。

status

VARCHAR2 (100) NOT NULL

書込み同時実行モードの移行状態。次のいずれかです。
IN TRANSITIONまたはCOMPLETE。

msg

VARCHAR2 (5000)

NULLまたはステータスの説明メッセージ。

例

次の例では、データベースが同時書込み処理用に最適化されたかを確認する方法を示します。

Command> CALL ttDbWriteConcurrencyModeGet();

< 2013-09-23 13:48:21.207599, 1, <NULL>, COMPLETE, <NULL> >
1 row found.

結果は、2013年9月23日午後1時48分ごろにデータベースが同時書込み処理のために最適化されたことを示しています。モードは移行していません。

関連項目

ttDbWriteConcurrencyModeSet

ttDbWriteConcurrencyModeSet

説明

ttDbWriteConcurrencyModeSet組込みプロシージャは同時書込み処理中に読取り最適化を制御します。

モードを1に設定すると、拡張書込み同時実行モードが有効になり、読込み最適化が無効になります。モードを0 (ゼロ)に設定すると、拡張書込み同時実行モードが無効になり、読込み最適化が再び有効になります。モードを1に設定すると、すべてのトランザクションおよび文の表ロックのヒントが抑制されます。これはSELECT文および副問合せに対してヒントでトリガーされたSn表ロック、およびDML文に対してヒントでトリガーされたW表ロックにも影響します。表ロックのヒントを抑制すると、スター結合などの実行計画を促す他の表ロックのヒントも抑制されます。モード設定にかかわらず、表ロックのヒントでトリガーされない表ロックは影響されません。

必要な権限

このプロシージャを実行するにはADMIN権限が必要です。

構文

ttDbWriteConcurrencyModeSet(mode, wait)

パラメータ

ttDbWriteConcurrencyModeSetには次のパラメータがあります。

パラメータ

データ型

説明

mode

TT_INTEGERNOT NULL

書込み同時実行モード。
0: ヒントおよび標準的な最適化技術に従って最適化します。

1: 同時書込み処理を最適化します。

wait

TT_INTEGERNOT NULL

0: モード移行の開始後すぐに返します。
1: モード移行が完了するまで待機してから返します。これは、0以外の値にモードを設定する場合に役立ちます。モードを0に設定した場合、通常、waitを1に指定する必要はありません。

結果セット

ttDbWriteConcurrencyModeSetは結果セットを戻しません。

例

次の例では、標準的な最適化技術を有効にして、処理の開始後すぐに返すようにする方法を示します。

Command> CALL ttDbWriteConcurrencyModeSet(0,0);

注意

モードを1に設定する場合、すべてのトランザクションおよび文の表ロックのヒントは抑制されます。これはSELECT文および副問合せに対してヒントでトリガーされたSn表ロック、およびDML文に対してヒントでトリガーされたW表ロックにも影響します。表ロックのヒントを抑制すると、スター結合などの実行計画を促す他の表ロックのヒントも抑制されます。モード設定にかかわらず、表ロックのヒントでトリガーされない表ロックは影響されません。

関連項目

ttDbWriteConcurrencyModeGet

ttDurableCommit

説明

このプロシージャは、現在のトランザクションをコミット時に永続的にすることを指定します。このプロシージャは、DurableCommitsが無効であり、アプリケーションがデータベースに接続されている場合にかぎり有効です。

また、ttDurableCommitをコールすることによって、現在のトランザクションおよび以前にコミットされた遅延永続トランザクションもすべて永続的になります。ttDurableCommitをコールした後にコミットされたトランザクションに対しては効果がありません。ttDurableCommitはトランザクションをコミットしません。たとえば、アプリケーションをコミットするには、SQLTransactなどをコールする必要があります。

必要な権限

このプロシージャには、権限は必要ありません。

構文

ttDurableCommit()

パラメータ

ttDurableCommitにパラメータはありません。

結果セット

ttDurableCommitは結果を返しません。

例

CALL ttDurableCommit;

注意

コントローラやドライバによっては、コントローラ内のキャッシュ・メモリーにデータを書き込むだけであったり、書込みが終了したことがオペレーティング・システムに通知された後のいずれかの時点でディスクに書込みを行う場合があります。このような場合に電力障害が発生すると、永続的にコミットされたものと思っていた情報の一部が失われている可能性もあります。こうしたデータの損失を避けるには、処理の完了を通知する前に必ず記録メディアに書き込むようにディスクを構成するか、または無停電電源装置(UPS)を使用してください。

ttGridAttach

説明

このプロシージャは、既存のローカル・キャッシュ・グリッドにグリッド・メンバーをアタッチします。スタンドアロンのTimesTenデータベースまたはTimesTenアクティブ・スタンバイ・ペアをグリッド・メンバーにすることができます。

メンバーがアクティブ・スタンバイ・ペアの場合、ペアの両方のノードをグリッドにアタッチする必要があります。ttGridAttach組込みプロシージャをアクティブ・スタンバイ・ペアの各ノードからコールする場合、両方のノードのIPアドレスまたはホスト名を指定してください。

ttGridAttach組込みプロシージャは、キャッシュ・エージェントがまだ実行中でない場合に、エージェントを自動的に起動します。また、ttGridAttach組込みプロシージャは、指定されたTCP/IPポートをキャッシュ・エージェントに設定し、グローバル・キャッシュ・グループを容易にします。

このプロシージャによって設定される情報を取得するには、組込みプロシージャttGridNodeStatusをコールします。

まだ実行されていない場合は、このプロシージャによってキャッシュ・エージェントが起動されます。このプロシージャをリモートで実行することはできません。

必要な権限

このプロシージャには、CACHE_MANAGER権限が必要です。

構文

スタンドアロンのTimesTenデータベースの場合は、次のようになります。

ttGridAttach(currentNode, 'name1', IPAddr1, port1)

アクティブ・スタンバイ・ペアのノードの場合は、次のようになります。

ttGridAttach(currentNode, 'name1', IPAddr1, port1 'name2', IPAddr2, port2)

パラメータ

ttGridAttachには、次のパラメータがあります。

パラメータ

データ型

説明

currentNode

TT_INTEGERNOT NULL

マスター・データベース用のノード番号。このパラメータに有効な値は、次のとおりです。
1: スタンドアロンまたはアクティブ・マスター・データベース。

2 - スタンバイ・マスター・データベース。

name1

TT_VARCAR (30)

アクティブ・マスター・データベースのグリッド・メンバーを一意に識別する完全修飾名。

IPAddr1

TT_VARCHAR (128) NOT NULL

アクティブ・マスター・データベースが存在するノードのIPアドレス。

port1

TT_INTEGERNOT NULL

アクティブ・マスター・データベースまたはスタンドアロン・データベースのキャッシュ・エージェント・プロセスのポート番号。

name2

TT_VARCAR (30)

スタンバイ・マスター・データベースのグリッド・メンバーを一意に識別する完全修飾名。

IPAddr2

TT_VARCHAR (128)

スタンバイ・マスター・データベースが存在するノードのIPアドレス。

port2

TT_INTEGER

スタンバイ・マスター・データベースのキャッシュ・エージェント・プロセスのポート番号。

結果セット

ttGridAttachは結果を返しません。

例

スタンドアロンのTimesTenデータベースをグリッドにアタッチするには、次のように実行します。

CALL ttGridAttach (1, 'alone2','sys2',5002);

アクティブ・マスター・データベースをグリッドにアタッチするには、次のように実行します。

CALL ttGridAttach(1,'cacheact','sys1',5003,'cachestand','sys2',5004);

スタンバイ・マスター・データベースをグリッドにアタッチするには、次のように実行します。

CALL ttGridAttach(2,'cacheact','sys1',5003,'cachestand','sys2',5004);

アクティブおよびスタンバイのマスター・データ・ストアをアタッチするコールの内容は、ノード番号を除いて同じです。

関連項目

ttGridCheckOwner
ttGridCreate
ttGridDestroy
ttGridDetach
ttGridDetachList
ttGridDetachAll
ttGridGlobalCGResume
ttGridGlobalCGSuspend
ttGridNameSet
ttGridNodeStatus
『Oracle TimesTen Application-Tier Database Cacheユーザーズ・ガイド』のキャッシュ・グリッドの構成に関する説明

ttGridCheckOwner

説明

このプロシージャは、グローバル・キャッシュ・グループの行数が、所有者表の行数と同じかどうかをチェックします。このプロシージャは、キャッシュ・グリッドが実行されていない場合にのみコールしてください。

必要な権限

このプロシージャには、CACHE_MANAGER権限が必要です。

構文

ttGridCheckOwner(['cvName'], ['cvOwner'])

パラメータ

ttGridCheckOwnerには、次のオプションのパラメータがあります。

パラメータ

データ型

説明

cvName

TT_VARCHAR (30)

チェックするキャッシュ・グループの名前。NULLで、所有者が指定されている場合、所有者に所有されるすべてのキャッシュ・グループがチェックされます。NULLで、所有者が指定されていない場合、すべてのキャッシュ・グループがチェックされます。

cvOwner

TT_VARCHAR (30)

チェックするキャッシュ・グループの所有者。NULLの場合、すべてのキャッシュ・グループがチェックされます。

結果セット

ttGridCheckOwnerは結果を返しません。

例

ユーザーterryが所有するmygroupキャッシュ・グループの情報を取得するには、次のように実行します。

CALL ttGridCheckOwner ('mygroup', 'terry');

すべてのキャッシュ・グループの情報を取得するには、次のように実行します。

CALL ttGridCheckOwner();

関連項目

ttGridAttach
ttGridCreate
ttGridDestroy
ttGridDetach
ttGridDetachAll
ttGridDetachList
ttGridGlobalCGResume
ttGridGlobalCGSuspend
ttGridNameSet
ttGridNodeStatus
『Oracle TimesTen Application-Tier Database Cacheユーザーズ・ガイド』のキャッシュ・グリッドの構成に関する説明

ttGridCreate

説明

このプロシージャは、キャッシュ・グリッドを作成します。グリッドを作成するには、このプロシージャを一度のみ実行します。この組込みプロシージャは、スタンドアロンのデータベース、あるいはアクティブ・スタンバイ・ペアのアクティブ・マスター・データベースまたはスタンバイ・マスター・データベースから実行できます。

AUTOCOMMIT=0の場合は、このプロシージャをコールした後にコミットする必要があります。

必要な権限

このプロシージャには、CACHE_MANAGER権限が必要です。

構文

ttGridCreate('gridName')

パラメータ

ttGridCreateには、次のパラメータがあります。

パラメータ

データ型

説明

gridName

TT_VARCHAR (30) NOT NULL

グリッドの名前を指定します。

結果セット

ttGridCreateは結果を返しません。

例

mygridという名前のグリッドを作成するには、次のように実行します。

CALL ttGridCreate ('mygrid');

関連項目

ttGridAttach
ttGridCheckOwner
ttGridDestroy
ttGridDetach
ttGridDetachAll
ttGridDetachList
ttGridGlobalCGResume
ttGridGlobalCGSuspend
ttGridNameSet
ttGridNodeStatus
『Oracle TimesTen Application-Tier Database Cacheユーザーズ・ガイド』のキャッシュ・グリッドの構成に関する説明

ttGridDestroy

説明

このプロシージャは、Oracle Databaseに格納されているすべてのキャッシュ・グリッド・オブジェクトを削除して、キャッシュ・グリッドを破棄します。

デフォルトでは、この組込みプロシージャは、アタッチ中のメンバーまたは既存のキャッシュ・グループが存在する間は、グリッドを破棄しません。

キャッシュ・グリッドを破棄する前に、キャッシュ・グリッドからすべてのTimesTenデータベースをデタッチしてください。グリッドを強制的に破棄するには、forceパラメータの引数に1を指定します。

必要な権限

このプロシージャには、CACHE_MANAGER権限が必要です。

構文

ttGridDestroy('gridName', [force])

パラメータ

ttGridDestroyには、次のパラメータがあります。

パラメータ

データ型

説明

gridName

TT_VARCHAR (30) NOT NULL

破棄するグリッドの完全修飾名。

force

TT_INTEGER

このオプションのパラメータでは、キャッシュ・グリッドにアタッチされているグリッド・メンバーが残っている場合、またはキャッシュ・グループがまだ含まれている場合でも、強制的にキャッシュ・グリッドが破棄されます。有効な値は1です。

結果セット

ttGridDestroyは結果を返しません。

例

mygridキャッシュ・グリッドを強制的に破棄するには、次のように実行します。

CALL ttGridDestroy ('mygrid', 1);

関連項目

ttGridAttach
ttGridCheckOwner
ttGridCreate
ttGridDetach
ttGridDetachAll
ttGridDetachList
ttGridGlobalCGResume
ttGridGlobalCGSuspend
ttGridNameSet
ttGridNodeStatus
『Oracle TimesTen Application-Tier Database Cacheユーザーズ・ガイド』のキャッシュ・グリッドの構成に関する説明

ttGridDetach

説明

このプロシージャは、キャッシュ・グリッドからノードをデタッチします。

このプロシージャは、キャッシュ・グリッドを破棄する前に使用します。キャッシュ・グリッドにアタッチされているノードがある場合、キャッシュ・グリッドを破棄できません。

必要な権限

このプロシージャには、CACHE_MANAGER権限が必要です。

構文

ttGridDetach(['nodeMemberName',] [force] [oraclePropWaitSec])

パラメータ

ttGridDetachには、次のオプションのパラメータがあります。

パラメータ

データ型

説明

nodeMemberName

TT_VARCHAR (200)

グリッドからデタッチするノードを指定します。
アクティブ・スタンバイ・ペアの場合、各ノードを個別にデタッチする必要があります。

force

TT_INTEGER

ノードが停止しているかどうかをチェックせずにそのノードがデタッチされます。有効な値は1です。

oraclePropWaitSec

TT_INTEGER

ノードをデタッチする前に、すべてのトランザクションがOracle Databaseに伝播されるまで待機する時間(秒)を指定します。-1は永久に待機することを表します。値を指定しない場合、ttGridDetachの待機時間は1秒になります。

結果セット

ttGridDetachは結果を返しません。

例

現在のノードをグリッドからデタッチするには、次のように実行します。

CALL ttGridDetach();

リモート・ノードTTGRID_alone2_2をグリッドからデタッチするには、次のように実行します。

CALL ttGridDetach('TTGRID_alone2_2',1);

関連項目

ttGridAttach
ttGridCheckOwner
ttGridCreate
ttGridDetachAll
ttGridDetachList
ttGridDestroy
ttGridGlobalCGResume
ttGridGlobalCGSuspend
ttGridNameSet
ttGridNodeStatus
『Oracle TimesTen Application-Tier Database Cacheユーザーズ・ガイド』のキャッシュ・グリッドの構成に関する説明

ttGridDetachAll

説明

このプロシージャは、アタッチされているすべてのメンバーをグリッドからデタッチします。スタンドアロンのTimesTenデータベースまたはTimesTenアクティブ・スタンバイ・ペアをグリッド・メンバーにすることができます。

まだ実行されていない場合は、このプロシージャによってキャッシュ・エージェントが起動されます。

必要な権限

このプロシージャには、CACHE_MANAGER権限が必要です。

構文

ttGridDetachAll([oraclePropWaitSec])

パラメータ

ttGridDetachAllには、次のオプションのパラメータがあります。

パラメータ

データ型

説明

oraclePropWaitSec

TT_INTEGER

すべてのノードをデタッチする前に、すべてのトランザクションがOracle Databaseに伝播されるまで待機する時間(秒)を指定します。-1は永久に待機することを表します。値を指定しない場合、ttGridDetachAllの待機時間は1秒になります。

結果セット

ttGridDetachAllは結果を返しません。

例

すべてのグリッド・メンバーをデタッチするには、次のように実行します。

CALL ttGridDetachAll();

関連項目

ttGridAttach
ttGridCheckOwner
ttGridCreate
ttGridDestroy
ttGridDetach
ttGridDetachList
ttGridGlobalCGResume
ttGridGlobalCGSuspend
ttGridNameSet
ttGridNodeStatus
『Oracle TimesTen Application-Tier Database Cacheユーザーズ・ガイド』のキャッシュ・グリッドの構成に関する説明

ttGridDetachList

説明

このプロシージャは、リスト内のノードをデタッチします。リモートのノードは使用不可であるため、このようなノードに対して有効です。

必要な権限

このプロシージャには、CACHE_MANAGER権限が必要です。

構文

ttGridDetachList('nodeMemberName1 [nodeMemberName2 ...]'
[,force] [oraclePropWaitSec])

パラメータ

ttGridDetachListには、次のパラメータがあります。

パラメータ

データ型

説明

nodeMemberName

TT_VARCHAR (8192) NOT NULL

削除するノードの完全修飾名。

force

TT_INTEGER

このオプションのパラメータでは、ノードが停止しているかどうかをチェックせずにノードがデタッチされます。有効な値は1です。

oraclePropWaitSec

TT_INTEGER

このオプションのパラメータでは、リスト内のノードをデタッチする前に、すべてのトランザクションがOracle Databaseに伝播されるまで待機する時間(秒)を指定します。-1は永久に待機することを表します。値を指定しない場合、ttGridDetachListの待機時間は1秒になります。

結果セット

ttGridDetachListは結果を返しません。

例

CALL ttGridDetachList('TTGRID_cacheact_3A TTGRID_cachestand_3B',1, );

関連項目

ttGridAttach
ttGridCheckOwner
ttGridCreate
ttGridDetach
ttGridDetachAll
ttGridDestroy
ttGridGlobalCGResume
ttGridGlobalCGSuspend
ttGridNameSet
ttGridNodeStatus
『Oracle TimesTen Application-Tier Database Cacheユーザーズ・ガイド』キャッシュ・グリッドの構成に関する説明

ttGridFirstMemberAttach

説明

このプロシージャは、ttGridAttach組込みプロシージャと似ています。ここでは、グリッドのアタッチされているすべてのメンバーが停止した場合、このプロシージャをコールしてグリッドの最初のメンバーをアタッチします。

このプロシージャは、1つのメンバーからのみコールしてください。この組込みプロシージャをコールする前に、他のすべてのメンバーのキャッシュ・エージェントが停止していることを確認します(そうでない場合、プロシージャで障害が発生します)。

ttGridFirstMemberAttach組込みプロシージャは、キャッシュ・エージェントがまだ実行中でない場合に、エージェントを自動的に起動します。また、ttGridFirstMemberAttach組込みプロシージャは、指定されたTCP/IPポートをキャッシュ・エージェントに設定し、グローバル・キャッシュ・グループを容易にします。

このプロシージャによって設定される情報を取得するには、組込みプロシージャttGridNodeStatusをコールします。

まだ実行されていない場合は、このプロシージャによってキャッシュ・エージェントが起動されます。このプロシージャをリモートで実行することはできません。

必要な権限

このプロシージャには、CACHE_MANAGER権限が必要です。

構文

スタンドアロンのTimesTenデータベースの場合は、次のようになります。

ttGridFirstMemberAttach(currentNode, 'name1', IPAddr1, port1)

アクティブ・スタンバイ・ペアのノードの場合は、次のようになります。

ttGridFirstMemberAttach(currentNode, 'name1',
IPAddr1, port1 'name2', IPAddr2, port2)

パラメータ

ttGridFirstMemberAttachには、次のパラメータがあります。

パラメータ

データ型

説明

currentNode

TT_INTEGERNOT NULL

マスター・データベース用のノード番号。このパラメータに有効な値は、次のとおりです。
1: スタンドアロンまたはアクティブ・マスター・データベース。

2 - スタンバイ・マスター・データベース。

name1

TT_VARCHAR (30)

アクティブ・マスター・データベースのグリッド・メンバーを一意に識別する完全修飾名。

IPAddr1

TT_VARCHAR (128) NOT NULL

アクティブ・マスター・データベースが存在するノードのIPアドレス。

port1

TT_INTEGERNOT NULL

アクティブ・マスター・データベースまたはスタンドアロン・データベースのキャッシュ・エージェント・プロセスのポート番号。

name2

TT_VARCAR (30)

スタンバイ・マスター・データベースのグリッド・メンバーを一意に識別する完全修飾名。

IPAddr2

TT_VARCHAR (128)

スタンバイ・マスター・データベースが存在するノードのIPアドレス。

port2

TT_INTEGER

スタンバイ・マスター・データベースのキャッシュ・エージェント・プロセスのポート番号。

結果セット

ttGridFirstMemberAttachは結果を返しません。

例

スタンドアロンのTimesTenデータベースをグリッドにアタッチするには、次のように実行します。

CALL ttGridFirstMemberAttach (1, 'alone2','sys2',5002);

関連項目

ttGridCheckOwner
ttGridCreate
ttGridDestroy
ttGridDetach
ttGridDetachList
ttGridDetachAll
ttGridGlobalCGResume
ttGridGlobalCGSuspend
ttGridNameSet
ttGridNodeStatus
『Oracle TimesTen Application-Tier Database Cacheユーザーズ・ガイド』のキャッシュ・グリッドの構成に関する説明

ttGridGlobalCGResume

説明

このプロシージャは、ttGridGlobalCGSuspendへのコール後にブロックされた処理を再開します。

必要な権限

このプロシージャには、CACHE_MANAGER権限が必要です。

構文

ttGridGlobalCGResume()

パラメータ

ttGridGlobalCGResumeにパラメータはありません。

結果セット

ttGridGlobalCGResumeは結果を返しません。

例

すべてのグリッド・メンバーをデタッチするには、次のように実行します。

CALL ttGridGlobalCGResume();

関連項目

ttGridAttach
ttGridCheckOwner
ttGridCreate
ttGridDestroy
ttGridDetach
ttGridDetachAll
ttGridDetachList
ttGridGlobalCGSuspend
ttGridNameSet
ttGridNodeStatus
『Oracle TimesTen Application-Tier Database Cacheユーザーズ・ガイド』のキャッシュ・グリッドの構成に関する説明

ttGridGlobalCGSuspend

説明

このプロシージャは、グローバル・キャッシュ・グループのキャッシュ・インスタンスの動的なロードおよび削除を一時的にブロックします。これらのアクションを再度有効にするには、ttGridGlobalCGResumeプロシージャを使用します。

必要な権限

このプロシージャには、CACHE_MANAGER権限が必要です。

構文

ttGridGlobalCGSuspend(wait)

パラメータ

ttGridGlobalCGSuspendには、次のパラメータがあります。

パラメータ

データ型

説明

wait

TT_INTEGER

保留中の削除処理がOracle Databaseに伝播されるか、保留中の透過的ロード処理が完了して戻されるまでコマンドが待機する秒数です。保留中の削除処理または保留中の透過的ロード処理が指定した時間内に完了できなかった場合に、TimesTenはエラーを返します。
値が指定されない場合は、待機時間はありません。

結果セット

ttGridGlobalCGSuspendは結果を返しません。

例

待機時間を10秒に設定するには、次のようにします。

CALL ttGridGlobalCGSuspend(10);

関連項目

ttGridAttach
ttGridCheckOwner
ttGridCreate
ttGridDestroy
ttGridDetach
ttGridDetachAll
ttGridDetachList
ttGridGlobalCGResume
ttGridNameSet
ttGridNodeStatus
『Oracle TimesTen Application-Tier Database Cacheユーザーズ・ガイド』のキャッシュ・グリッドの構成に関する説明

ttGridInfo

説明

このプロシージャは、指定されたキャッシュ・グリッドまたはすべてのキャッシュ・グリッドに関する情報を返します。

必要な権限

このプロシージャには、CACHE_MANAGER権限が必要です。

構文

ttGridInfo(['gridName'])

パラメータ

ttGridInfoには、次のオプションのパラメータがあります。

パラメータ

データ型

説明

gridName

TT_VARCHAR (30)

gridNameが指定された場合、指定されたグリッドに関する情報が表示されます。指定されていない場合は、すべてのグリッドに関する情報が表示されます。

結果セット

ttGridInfoによって、キャッシュ・グリッドに関する情報が返されます。

列

データ型

説明

gridName

TT_VARCHAR (30)

指定されたグリッドの名前。

cacheAdminID

TT_VARCHAR (30)
NOT NULL

グリッドに関連付けられているキャッシュ管理ユーザーID。

platform

TT_VARCHAR (100)

グリッドが稼働しているオペレーティング・システム・プラットフォーム。
プラットフォーム値は次のように表示されます。

オペレーティング・システム, ビット・レベル

次に例を示します。

<. . ., Solaris x86, 64-bit, . . .>

major1

TT_VARCHAR (10)

グリッドに関連付けられているTimesTenのメジャー・リリースの最初の番号。たとえば、リリースが11.2.2の場合、11となります。

major2

TT_VARCHAR (10)

グリッドに関連付けられているTimesTenのメジャー・リリースの2番目の番号。たとえば、リリースが11.2.2の場合、2となります。

major3

TT_VARCHAR (10)

グリッドに関連付けられているTimesTenのメジャー・リリースの3番目の番号。たとえば、リリースが11.2.2の場合、2となります。

例

mygridキャッシュ・グリッドの情報を取得するには、次のように実行します。

CALL ttGridInfo ('mygrid');
< MYGRID, CACHEUSER, Linux Intel x86, 32-bit, 11, 2, 2 >

すべてのグリッドの情報を取得するには、次のように実行します。

CALL ttGridInfo();

関連項目

ttGridAttach
ttGridCheckOwner
ttGridCreate
ttGridDestroy
ttGridDetach
ttGridDetachAll
ttGridDetachList
ttGridGlobalCGResume
ttGridGlobalCGSuspend
ttGridNameSet
ttGridNodeStatus
『Oracle TimesTen Application-Tier Database Cacheユーザーズ・ガイド』のキャッシュ・グリッドの構成に関する説明

ttGridNameSet

説明

このプロシージャは、TimesTenデータベースをグリッドに関連付けます。

必要な権限

このプロシージャには、CACHE_MANAGER権限が必要です。

構文

ttGridNameSet('gridName')

パラメータ

ttGridNameSetには、次のパラメータがあります。

パラメータ

データ型

説明

gridName

TT_VARCHAR (30)

プロシージャをコールするTimesTenデータベースを、gridNameで指定されたグリッドに関連付けます。

結果セット

ttGridNameSetは結果を返しません。

例

データベースをグリッドmygridに関連付けるには、次のように実行します。

CALL ttGridNameSet('mygrid');

関連項目

ttGridAttach
ttGridCheckOwner
ttGridCreate
ttGridDestroy
ttGridDetach
ttGridDetachAll
ttGridDetachList
ttGridGlobalCGResume
ttGridGlobalCGSuspend
ttGridNodeStatus
『Oracle TimesTen Application-Tier Database Cacheユーザーズ・ガイド』のキャッシュ・グリッドの構成に関する説明

ttGridNodeStatus

説明

このプロシージャは、指定されたキャッシュ・グリッドのすべてのメンバーに関する情報を返します。グリッド名が指定されない場合、Oracle Databaseに関連付けられているすべてのキャッシュ・グリッドのすべてのメンバーに関する情報を表示します。

必要な権限

このプロシージャには、CACHE_MANAGER権限が必要です。

構文

ttGridNodeStatus(['gridName'])

パラメータ

ttGridNodeStatusには、次のオプションのパラメータがあります。

パラメータ

データ型

説明

gridName

TT_VARCHAR (30)

gridNameが指定された場合、指定されたグリッドのすべてのメンバーに関する情報が表示されます。指定されていない場合は、すべてのグリッドに関する情報が表示されます。

結果セット

ttGridNodeStatusは次の結果を返します。

列

データ型

説明

gridName

TT_VARCHAR (30)

グリッドの名前。

nodeID

TT_INTEGERNOT NULL

グリッド・ノードの一意のID。

activeNode

TT_INTEGERNOT NULL

アクティブ・マスター・データベースまたはスタンドアロン・データベースが現在存在するノードの番号。

node1Attached

CHAR (1) NOT NULL

アクティブ・ノードがグリッドにアタッチされているかどうかを示します。
T: アクティブ・ノードはアタッチされています。

F: アクティブ・ノードはデタッチされています。

Host1

TT_VARCHAR (200) NOT NULL

アクティブ・データベースが存在するホスト名。

memberName1

TT_VARCHAR (200) NOT NULL

スタンドアロン・データベースまたはアクティブ・スタンバイ・データベースの一意のメンバー名。

IPaddr1

TT_VARCHAR (128) NOT NULL

アクティブ・マスター・データベースまたはスタンドアロン・データベースが存在する場所のIPアドレス。

port1

TT_INTEGERNOT NULL

アクティブ・マスター・データベースまたはスタンドアロン・データベースのキャッシュ・エージェント・プロセスのポート番号。

node2Attached

CHAR (1)

スタンバイ・ノードがグリッドにアタッチされているかどうかを示します。
T: スタンバイ・ノードはアタッチされています。

F: スタンバイ・ノードはデタッチされています。

host2

TT_VARCHAR (200)

スタンバイ・マスター・データベースが存在するホスト名。

memberName2

TT_VARCHAR (200)

スタンドアロン・データベースまたはアクティブ・スタンバイ・データベースの一意のメンバー名。

IPaddr2

TT_VARCHAR (128)

スタンバイ・マスター・データベースが存在するIPアドレス。

port2

TT_INTEGER

スタンバイ・マスター・データベースのキャッシュ・エージェント・プロセスのポート番号。

スタンドアロン・データベースのグリッド・メンバーの場合、結果セットに表示される列数はアクティブ・スタンバイ・ペアのメンバーよりも少なくなります。

例

ttgridがデータベースの唯一のキャッシュ・グリッドの場合、そのメンバーに関する情報を表示するには、次のように実行します。

Command> call ttGridNodeStatus;

< TTGRID, 1, 1, T, sys1, TTGRID_alone1_1, 140.87.0.201, 5001, <NULL>,
<NULL>,<NULL>, <NULL>, <NULL> >
< TTGRID, 2, 1, T, sys2, TTGRID_alone2_2, 140.87.0.202, 5002, <NULL>,
<NULL>,<NULL>, <NULL>, <NULL> >
< TTGRID, 3, 1, T, sys3, TTGRID_cacheact_3A, 140.87.0.203, 5003, T,
sys4, TTGRID_cachestand_3B, 140.87.0.204, 5004 >

関連項目

ttGridAttach
ttGridCheckOwner
ttGridCreate
ttGridDestroy
ttGridDetach
ttGridDetachAll
ttGridDetachList
ttGridGlobalCGResume
ttGridGlobalCGSuspend
ttGridNameSet
『Oracle TimesTen Application-Tier Database Cacheユーザーズ・ガイド』のキャッシュ・グリッドの構成に関する説明

ttHostNameGet

説明

このプロシージャは、現在のローカル・ホスト名を返します。戻り値は、現在のセッションでのみ有効です。システム全体に対する設定ではなく、現在のセッションが切断された後は無効になります。

スキーム内の特定のストア名が現在のホストを参照しているかどうかを確認する場合に、このプロシージャを使用します。これは、レプリケーション・スキームを構成する際に便利です。

必要な権限

このプロシージャには、権限は必要ありません。

構文

ttHostnameGet()

パラメータ

ttHostNameGetにパラメータはありません。

結果セット

ttHostNameGetは次の結果を返します。

列

データ型

説明

hostName

TT_VARCHAR (200)

データベースの現在のデフォルトのローカル・ホスト設定。デフォルトが指定されていない場合は、現在のホスト名が返されます。

例

CALL ttHostNameGet ();

関連項目

ttHostNameSet
『Oracle TimesTen In-Memory Database開発者および管理者ガイド』の「レプリケート・システムの設定」

ttHostNameSet

説明

このプロシージャは、現在のデータベースのデフォルトのローカル・ホスト名を指定します。この値は、現在のセッションのみで使用される値であり、システム全体に対する設定値ではなく、現在のセッションの接続が切断されると無効になります。

マスター/サブスクライバの関係およびレプリケーション・オブジェクトのアクセス権を正しく構成するには、スクリプトが現在実行されているコンピュータをレプリケーション・スキームで使用されるホスト名が参照しているかどうかを、レプリケーションDDLのプロセスで判断できることが必要です。このプロシージャを使用すると、現在のホスト名を確立する必要があるときにはいつでも、レプリケーションDDLのプロセスが使用する現在のセッションのデフォルト・ホスト名をアプリケーションから設定できるようになります。

必要な権限

このプロシージャには、ADMIN権限が必要です。

構文

ttHostnameSet('hostName')

パラメータ

ttHostNameSetには、次のパラメータがあります。

パラメータ

データ型

説明

hostName

TT_VARCHAR (200)

ローカル・コンピュータの必要なデフォルト名。デフォルト値をクリアするには、NULLを指定します。

結果セット

ttHostNameSetは結果を返しません。

例

CALL ttHostNameSet ('alias1');

注意

hostNameの有効な値は、localhost、127.0.0.1または::1以外の任意のホスト名またはIPアドレスです。既存のレプリケーション・スキームで使用されているローカル・ホスト名と異なる値を、デフォルト・ホスト名に設定することはできません。

関連項目

ttHostNameGet
『Oracle TimesTen In-Memory Database開発者および管理者ガイド』の「レプリケート・システムの設定」

ttIndexAdviceCaptureDrop

説明

このプロシージャは現在の接続または現在のデータベースの既存の取得データを削除します。そのレベルのttIndexAdviceCaptureOutputへの後続のコールは行を返しません。

このプロシージャおよびこれに関連するプロシージャをIndex Advisorと呼びます。これらのプロシージャの使用法の詳細は、『Oracle TimesTen In-Memory Databaseオペレーション・ガイド』の索引を推奨するためのIndex Advisorの使用に関する説明を参照してください。

必要な権限

このプロシージャでは接続レベルの取得を削除するために権限を必要としません。

このプロシージャでは、データベース・レベルの取得を削除するためにADMIN権限が必要です。

構文

ttIndexAdviceCaptureDrop([captureLevel])

パラメータ

ttIndexAdviceCaptureDropには次のオプション・パラメータがあります。

パラメータ

データ型

説明

captureLevel

TT_INTEGER

取得レベルの有効な値は次のとおりです。
0 - 索引アドバイス取得は、現在の接続の接続レベルで削除されます。これはデフォルトです。

1 - 索引アドバイス取得はデータベース・レベルで削除されます。

結果セット

ttIndexAdviceCaptureDropは結果を返しません。

例

CALL ttIndexAdviceCaptureDrop;

注意

接続レベルの取得とデータベース・レベルの取得の両方を削除するには、コマンドを2回呼び出します(それぞれの取得レベルについて1回ずつ)。

削除を試行しているレベルで取得が進行中にこのコマンドをコールすると、エラーになります。

関連項目

ttIndexAdviceCaptureEnd
ttIndexAdviceCaptureInfoGet
ttIndexAdviceCaptureOutput
ttIndexAdviceCaptureStart
『Oracle TimesTen In-Memory Databaseオペレーション・ガイド』の索引アドバイザを使用した索引の推奨に関する説明

ttIndexAdviceCaptureEnd

説明

このプロシージャは現在の接続のアクティブな接続レベルの取得またはアクティブなデータベース・レベルの取得のいずれかを終了します。

このプロシージャおよびこれに関連するプロシージャをIndex Advisorと呼びます。これらのプロシージャの使用法の詳細は、『Oracle TimesTen In-Memory Databaseオペレーション・ガイド』の索引を推奨するためのIndex Advisorの使用に関する説明を参照してください。

必要な権限

このプロシージャでは接続レベルの取得を終了するために権限を必要としません。

このプロシージャではデータベース・レベルの取得を終了するためにADMIN権限が必要です。

構文

ttIndexAdviceCaptureEnd([captureLevel])

パラメータ

ttIndexAdviceCaptureEndには次のオプション・パラメータがあります。

パラメータ

データ型

説明

captureLevel

TT_INTEGER

取得レベルの有効な値は次のとおりです。
0 - 現在の接続の接続レベルでの索引アドバイス取得を終了します。これはデフォルトです。

1 - データベース・レベルの索引アドバイス取得を終了します。

結果セット

ttIndexAdviceCaptureEndは結果を返しません。

例

次の例では、接続レベルの取得の収集を終了します。

Call ttIndexAdviceCaptureEnd(0)

注意

接続レベルの取得とデータベース・レベルの取得の両方を終了するには、コマンドを2回呼び出します(それぞれの収集レベルについて1回ずつ)。

最初にttIndexAdviceCaptureStartプロシージャをコールして、指定したレベルで取得を開始せずにこのプロシージャをコールすると、エラーになります。

関連項目

ttIndexAdviceCaptureDrop
ttIndexAdviceCaptureInfoGet
ttIndexAdviceCaptureOutput
ttIndexAdviceCaptureStart
『Oracle TimesTen In-Memory Databaseオペレーション・ガイド』の索引を推奨するためのIndex Advisorの使用に関する説明

ttIndexAdviceCaptureInfoGet

説明

このプロシージャはアクティブな取得に対して行を返します。取得は、索引アドバイス取得を開始した場合、または索引アドバイス取得は中止したが取得データがまだ使用可能な場合は、アクティブです。

接続レベルの取得が存在する場合、1行が接続レベルの取得に関連します。データベース・レベルの取得が存在する場合は、別の行がデータベース・レベルの取得に関連します。最大で、1つの接続レベルの取得と1つのデータベース・レベルの取得が存在します。

進行中の取得がなく、データが存在しない場合、このプロシージャは行を返しません。

このプロシージャおよびこれに関連するプロシージャをIndex Advisorと呼びます。これらのプロシージャの使用法の詳細は、『Oracle TimesTen In-Memory Databaseオペレーション・ガイド』の索引を推奨するためのIndex Advisorの使用に関する説明を参照してください。

必要な権限

このプロシージャは接続レベルの取得に関する情報を取得するための権限を必要としません。

このプロシージャではデータベース・レベルの取得に関する情報を取得するためにADMIN権限が必要です。

構文

ttIndexAdviceCaptureInfoGet()

パラメータ

ttIndexAdviceCaptureInfoGetにパラメータはありません。

結果セット

ttIndexAdviceCaptureInfoGetは次の結果セットを返します。

列

データ型

説明

captureState

TT_INTEGERNOT NULL

取得の状態は次のとおりです。
0 - 取得は進行中ではありません。

1: 取得が進行中です。

connID

TT_INTEGER

最後の取得、または現在進行中の取得がある場合はその取得を開始した接続の接続ID。
取得が開始されていない場合には、この行は返されません。

captureLevel

TT_INTEGER

一番新しい取得のレベル。
取得が開始されていない場合には、この行は返されません。

captureMode

TT_INTEGER

一番新しい取得のモード。
取得が開始されていない場合には、この行は返されません。

numPrepared

TT_INTEGER

取得期間に準備された文の数。
開始された取得がない場合、この値はNULLです。

numExecuted

TT_INTEGER

取得期間に実行された文の数。
開始された取得がない場合、この値はNULLです。

captureStartTime

TT_TIMESTAMP

取得期間の開始時のタイム・スタンプ。
取得が開始されていない場合には、この行は返されません。

captureEndTime

TT_TIMESTAMP

取得期間の終了時のタイム・スタンプ。
取得が進行中でない場合、この値はNULLになります。

例

この例は、363の作成済の文および369の実行された文に対する、完了した接続レベルの取得の取得情報を示しています。

Command> CALL ttIndexAdviceCaptureInfoGet();
< 0, 1, 0, 0, 363, 369, 2012-07-27 11:44:08.136833,
2012-07-27 12:07:35.410993 >
1 row found.

注意

アクティブなデータベース・レベルの取得が存在し、ADMIN権限を持たない接続に対してこのプロシージャをコールした場合は、TimesTenによりエラーが返されます。

関連項目

ttIndexAdviceCaptureDrop
ttIndexAdviceCaptureEnd
ttIndexAdviceCaptureOutput
ttIndexAdviceCaptureStart
『Oracle TimesTen In-Memory Databaseオペレーション・ガイド』の索引を推奨するためのIndex Advisorの使用に関する説明

ttIndexAdviceCaptureOutput

説明

この組込みプロシージャは、指定したレベルで最後に記録された取得の索引の推奨リストを返します。また、推奨された索引を作成するための実行可能CREATE INDEX SQL文も返します。

このプロシージャおよびこれに関連するプロシージャをIndex Advisorと呼びます。これらのプロシージャの使用法の詳細は、『Oracle TimesTen In-Memory Databaseオペレーション・ガイド』の索引を推奨するためのIndex Advisorの使用に関する説明を参照してください。

接続レベルの取得の場合は、その取得が開始された接続と同じ接続でこのプロシージャを実行します。データベース・レベルの取得の場合は、ADMIN権限のある接続でこのプロシージャを実行します。

必要な権限

このプロシージャは接続レベルの取得に関する出力を取得するための権限を必要としません。

このプロシージャではデータベース・レベルの取得に関する出力を取得するためにADMIN権限が必要です。

構文

ttIndexAdviceCaptureOutput([captureLevel])

パラメータ

ttIndexAdviceCaptureOutputには、次のパラメータがあります。

パラメータ

データ型

説明

captureLevel

TT_INTEGER

取得レベルの有効な値は次のとおりです。
0 - 現在の接続の接続レベルで索引アドバイスを出力します。これはデフォルト値です。

1 - データベース・レベルで索引アドバイスを出力します。

結果セット

ttIndexAdviceCaptureOutputは次の結果セットを返します。

列

データ型

説明

stmtCount

TT_INTEGER

この索引が存在していた場合はその索引を利用した可能性がある、取得ワークロードでの文の数。

createStmt

TT_VARCHAR (8300) NOT NULL

推奨された索引を作成できる実行可能文。

例

次の例は、HR.PURCHASE表のPURCHASE_i1と呼ばれる索引のCREATE INDEX文を示しています。このSQLワークロードの索引を利用する可能性のある文は、4つ、別々にあります。

CALL ttIndexAdviceCaptureOutput();
< 4, create index PURCHASE_i1 on HR.PURCHASE(AMOUNT); >
1 row found.

注意

返されるすべての名前はスキーマの完全修飾名です。

関連項目

ttIndexAdviceCaptureDrop
ttIndexAdviceCaptureEnd
ttIndexAdviceCaptureInfoGet
ttIndexAdviceCaptureStart
『Oracle TimesTen In-Memory Databaseオペレーション・ガイド』の索引を推奨するためのIndex Advisorの使用に関する説明

ttIndexAdviceCaptureStart

説明

このプロシージャは索引アドバイス取得を有効化します。このプロシージャをコールする前に、ttOptEstimateStatsを使用して統計を更新し、'invalidate'パラメータを'yes'に設定することをお薦めします。この方法で統計を更新することにより、統計を最新の状態にしておくことができ、取得中に文を強制的に再作成できます。かわりに、統計を既知の値に設定するには、'invalidate'パラメータを'yes'に設定してttOptSetTblStatsをコールします。

このプロシージャおよびこれに関連するプロシージャをIndex Advisorと呼びます。これらのプロシージャの使用法の詳細は、『Oracle TimesTen In-Memory Databaseオペレーション・ガイド』の索引を推奨するためのIndex Advisorの使用に関する説明を参照してください。

必要な権限

このプロシージャでは接続レベルの取得を開始するために権限を必要としません。

このプロシージャでは、データベース・レベルの取得を開始するためにADMIN権限が必要です。

構文

ttIndexAdviceCaptureStart([captureLevel], [captureMode])

パラメータ

ttIndexAdviceCaptureStartには、次のオプションのパラメータがあります。

パラメータ

データ型

説明

captureLevel

TT_INTEGER

取得レベルの有効な値は次のとおりです。
0 - 現在の接続の接続レベルで索引アドバイスを出力します。これはデフォルト値です。

1 - データベース・レベルで索引アドバイスを出力します。

captureMode

TT_INTEGER

取得モードの有効な値は次のとおりです。
0: SQL文の実行を含む、索引アドバイスの完全な取得を指定します。これはデフォルトです。

31 - 取得は計算された統計およびプラン分析のみに基づきます。問合せ(SELECT文のみ)は作成されますが、実行されません。このモードは接続レベルの取得でのみ使用できます(captureLevel=0)。

結果セット

ttIndexAdviceCaptureStartは結果を返しません。

例

次の例では接続レベルでIndex Advisorの収集を開始します。

Call ttIndexAdviceCaptureStart(0,0);

注意

索引アドバイスがcaptureLevelパラメータで指定されたレベルで、またはレベルが指定されていない場合には接続レベルですでに取得されている場合に、このプロシージャをコールするとエラーになります。接続レベルの取得は、競合せずに独立した接続で並行的に実行できます。データベース・レベルの取得の開始時に、残っている進行中の接続レベルの取得は予定どおりに終了します。

関連項目

ttIndexAdviceCaptureDrop
ttIndexAdviceCaptureEnd
ttIndexAdviceCaptureInfoGet
ttIndexAdviceCaptureOutput
『Oracle TimesTen In-Memory Databaseオペレーション・ガイド』の索引を推奨するためのIndex Advisorの使用に関する説明

ttLoadFromOracle

説明

このプロシージャはTimesTenの表名、Oracle SELECT文、およびパラレル・ロードのスレッド数をとります。Oracle Database表に対して問合せを実行し、指定したTimesTen表に結果セットをロードします。

Oracle DatabaseからTimesTenの表にデータをロードする際、キャラクタ・セットの変換は行われません。TimesTenデータベースとOracle Databaseは同じキャラクタ・セットを使用する必要があります。

このプロシージャでは接続属性UID、接続属性OraclePWDおよび接続属性OracleNetServiceNameを指定する必要があります。このプロシージャをコールした後に、コミットする必要があります。

詳細と使用法の情報については、『Oracle TimesTen In-Memory Databaseオペレーション・ガイド』のOracle DatabaseからTimesTen表へのデータのロードに関する説明を参照してください。

必要な権限

このプロシージャではロードされる表に対するINSERT権限が必要です。Oracle Databaseに対する問合せを実行するには、必要なすべての権限がセッションに必要です。

構文

ttLoadFromOracle(['tblOwner'], 'tblName', 'Query' [,numThreads])

パラメータ

ttLoadFromOracleには、次のパラメータがあります。

パラメータ

データ型

説明

tblOwner

TT_CHAR (30)

TimesTen表の所有者(オプション)。指定しない場合は、接続IDが使用されます。

tblName

TT_CHAR(30) NOT NULL

Oracle Databaseからのデータがロードされる表の名前。表がまだない場合には、組込みプロシージャttTableSchemaFromOraQueryGetを使用して、表を作成するスキーマを取得できます。
指定するTimesTen表はシステム表、シノニム、ビュー、マテリアライズド・ビューまたはマテリアライズド・ビューの詳細表、グローバル一時表、キャッシュ・グループ表とすることはできません。

Query

TT_VARCHAR (409600) NOT NULL

表の列定義を導出する、Oracle Databaseに対するSELECT問合せ。
Oracle Databaseに対する問合せはパラメータ・バインディングを持つことができません。SELECTリストのすべての式に、列別名を指定します。指定しない場合、実装に依存した列名が想定され、式は評価されません。

numThreads

TT_INTEGER

パラレル・ロードのスレッド数(オプション)。NULLの場合は、デフォルトの4になります。
表のパラレル・ロードを指定します。同時にロードを実行するスレッドの数を指定します。1つのスレッドがOracleからのバルク・フェッチを実行し、他のスレッドがTimesTenへの挿入を実行します。各スレッドで独自の接続またはトランザクションが使用されます。

NumThreadsの最小値は2です。最大値は10です。10より大きい値を指定すると、TimesTenは値10を割り当てます。

結果セット

ttLoadFromOracleは、次の結果セットを返します。

列

データ型

説明

numRows

TT_BIGINTNOT NULL

ロードされる行数を示す1つの数値。

例

次の例ではOracle DatabaseのHR.EMPLOYEES表から従業員に関する情報を選択し、それをTimesTen HR.EMPLOYEES表にロードしています。この例では、情報で107人の従業員が検出されました。

Command> CALL ttLoadFromOracle ('HR','EMPLOYEES',
'SELECT * FROM HR.EMPLOYEES');
< 107 >
1 row found.

注意

TimesTenはロードするまでは表を空にしません。ターゲット表には主キーが必要ありません。列タイプの不一致または列数の不一致により問合せの出力が表に変換できない場合、TimesTenはエラーを返します。TimesTen LOB列へのデータのロードはサポートされていません。Oracle Databaseに対する問合せにLOB出力がある場合、VAR型にマップされます。

ロード・プロセスでは、TimesTen表の列のデータ型とサイズが結果セットのデータ型とサイズに一致することを確認しません。かわりに、挿入が試行され、列のデータ型をマップできない場合、またはSQL問合せからのOracle DatabaseデータがTimesTenの列サイズを超える場合、TimesTenはエラーを返します。LOB列は4MBに切り捨てられます。

列を追加するために表を変更すると、セカンダリ・パーティションが追加されます。表への複数のパーティションのロードは、ttLoadFromOracleではサポートされていません。

関連項目

ttTableSchemaFromOraQueryGet

ttLockLevel

説明

この接続の次のトランザクションとすべての後続トランザクションに対して、行レベルのロックとデータベース・レベルのロックでロック・レベルを変更します。アプリケーションでは、再度ttLockLevelを呼び出すことによって、再度ロック・レベルを変更できます。初期値は、LockLevel接続属性によって異なります。各種ロック・レベルの詳細は、「LockLevel」を参照してください。

必要な権限

このプロシージャには、ADMIN権限が必要です。

構文

ttLockLevel('lockLevel')

パラメータ

ttLockLevelには、次のパラメータがあります。

パラメータ

データ型

説明

lockLevel

TT_CHAR(20) NOT NULL

接続で使用するロック・レベル。

lockLevelの値は次の文字列のいずれかで、大文字と小文字は区別されません。

Row: 行レベル・ロックに設定します。

DS: データベース・レベル・ロックに設定します。

結果セット

ttLockLevelは結果を返しません。

例

CALL ttLockLevel ('Row');

注意

このプロシージャは、現在のトランザクションには影響しません。

Oracle Databaseから表をキャッシュするには、行レベル・ロックが必要です。

このプロシージャは、トランザクション内からコールする必要があります。トランザクションを起動した接続に対する後続のトランザクションに、ロック・レベルを設定します。新しいロック・レベルは、現在のトランザクションには影響しません。次のトランザクションの開始時に有効になります。

関連項目

ttLockWait

ttLockWait

説明

このプロシージャは、アプリケーションで、現在の接続のロック・タイムアウト間隔を変更できるようにします。変更はただちに有効になり、現在のトランザクションでのすべての後続文および接続しているすべての後続トランザクションにも適用されます。

ロック待機時間は、ロックの競合が発生した際に待機する秒数です。秒の小数部も指定できます。

タイムアウトを検出するエージェントのスケジュールにより、ロック待機時間は不正確で、通常、最大100ミリ秒超過する場合があります。0(ゼロ)秒のタイムアウトの場合はこの不正確さは該当せず、タイムアウトはすぐにレポートされます。

キャッシュ・グリッドはロック待機時間とともにメッセージ待機時間を使用します。キャッシュ・グリッド使用時は、ロック待機時間は指定した値の約半分になります。アプリケーションでロック待機時間のすべてが必要な場合は、必要な秒数の2倍を指定します。

必要な権限

このプロシージャには、権限は必要ありません。

構文

ttLockWait(seconds)

パラメータ

ttLockWaitには、次の必須のパラメータがあります。

パラメータ

データ型

説明

seconds

NUMBER (8,1) NOT NULL

競合が発生した際にロックを待機する時間(秒)。秒の小数部も指定できます。有効な値は0.0から1000000.0の範囲です。

結果セット

ttLockWaitは結果を返しません。

例

ロック待機を6秒に指定するには、次のように実行します。

CALL ttLockWait (6);

ロック待機を10分の1秒に指定するには、次のように実行します。

CALL ttLockWait (0.1);

注意

TimesTenトランザクションは、ロックがただちに利用できない場合、事前に設定された時間だけ待機し、ロックを取得しようとします。その後、ロック・リクエストはタイムアウトになり、アプリケーションにエラーTT6003を返します。デフォルトでは、TimesTenはロック・タイムアウトに10秒の値を使用します。値0 (ゼロ)が指定された場合、トランザクションは利用できないロックを待機しません。

関連項目

ttLockLevel
「LockLevel」

ttLogHolds

説明

このプロシージャは、トランザクション・ログの保持に関する情報を返し、これには増分バックアップ、レプリケーション・ピア、アクティブ・スタンバイ・ペア(およびサブスクライバ)、AWTキャッシュ・グループ、永続XLAサブスクライバ、XA、長時間実行トランザクションおよびチェックポイントのかわりに作成されたログも含まれます。このプロシージャは、チェックポイント処理ですべての不要なトランザクション・ログ・ファイルが消去されていない可能性がある状況を診断する場合に役立ちます。

アプリケーションではログの保持とログ・ファイルの蓄積を監視する必要があります。詳細は、『Oracle TimesTen In-Memory Database開発者および管理者ガイド』のレプリケートされたログの保持の表示に関する説明および『Oracle TimesTen In-Memory Databaseオペレーション・ガイド』のトランザクション・ログ・ファイルの蓄積の監視に関する説明を参照してください。

必要な権限

このプロシージャには、権限は必要ありません。

構文

ttLogHolds()

パラメータ

ttLogHoldsにパラメータはありません。

結果セット

ttLogHoldsは次の結果セットを返します。

列

データ型

説明

HoldLFN

TT_INTEGERNOT NULL

保持されているトランザクション・ログ・ファイルの番号を返します。

HoldLFO

TT_BIGINTNOT NULL

保持されているトランザクション・ログ・ファイルのオフセットを返します。

type

TT_CHAR(30) NOT NULL

保持されているログ・タイプを返します。次のいずれかです。
Checkpoint

Replication

Backup

XLA

Long-Running Transaction

Long-Running XA Transaction

description

TT_VARCHAR (1024) NOT NULL

保持されたログ・タイプ固有のオブジェクトの説明です。それぞれの説明は、返されるタイプに対応しています。次のいずれかです。

- チェックポイント・ファイルの名前

- スタンバイ・マスターの名前

- レプリケーション・サブスクライバの名前

- AWTキャッシュ・グループの伝播追跡時の_ORACLE

- サブスクライバによって使用されるパラレル・レプリケーション追跡ID

- バックアップ・パス

- 永続XLAサブスクリプション名、および永続XLAサブスクリプションがオープンされている場合は、そのサブスクリプションをオープンした最後のプロセスのプロセスID

- XAトランザクションのXID(トランザクションID)

- 長時間実行トランザクションのTimesTenトランザクションID

例

CALL ttLogHolds();
< 0, 1148544, Long-Running XA Transaction ,
0x1-476c6f62616c-5861637431 >
< 0, 1149752, Long-Running Transaction, 4.2 >
< 0, 1149992, Checkpoint , sample.ds1 >
< 0, 1150168, Checkpoint , sample.ds0 >

次の例では、アクティブ・スタンバイ・ペアのレプリケーション・スキームに対するttLogHolds組込みプロシージャの出力を示します(アクティブ・マスターはmaster1、スタンバイ・マスターはmaster2、単一サブスクライバはsubscriber1です)。

Command> call ttLogHolds;
< 0, 3569664, Checkpoint                    , master1.ds0 >
< 0, 15742976, Checkpoint                    , master1.ds1 >
< 0, 16351496, Replication                   , ADC6160529:SUBSCRIBER1 >
< 0, 16351640, Replication                   , ADC6160529:MASTER2 >
4 rows found.

次の例では、Oracle DatabaseへのAWTキャッシュ・グループの非同期伝播の進行状況を示します。記述フィールドには、AWTキャッシュ・グループ伝播のトランザクション・ログの保持を識別するために「_ORACLE」が含まれます。

Command> call ttLogHolds();
< 0, 18958336, Checkpoint                    , cachealone1.ds0 >
< 0, 19048448, Checkpoint                    , cachealone1.ds1 >
< 0, 19050904, Replication                   , ADC6160529:_ORACLE >
3 rows found.

ttMonitorHighWaterReset

説明

このプロシージャは、MONITOR表のPERM_IN_USE_HIGH_WATER列の値をPERM_IN_USE_SIZE列の現在の値に設定し、MONITOR表のTEMP_IN_USE_HIGH_WATER列の値をTEMP_IN_USE_SIZE列の現在の値に設定します。これらの列は、アプリケーションの開発時およびデプロイ時にデータベースのサイジングに役立ちます。

必要な権限

このプロシージャには、ADMIN権限が必要です。

構文

ttMonitorHighWaterReset()

パラメータ

ttMonitorHighWaterResetにパラメータはありません。

結果セット

ttMonitorHighWaterResetは結果を返しません。

例

CALL ttMonitorHighWaterReset();

ttOptClearStats

説明

このプロシージャは、指定した表の統計を消去します(これによって、TimesTen問合せオプティマイザで、表に関連する後続の問合せに対して、推測値またはデフォルト値が使用されるようになります)。このプロシージャは、統計が古い場合や、アプリケーションで組込みのデフォルト値を使用する場合に役立ちます。このプロシージャによって、指定した表に関連するシステム表TBL_STATSおよびCOL_STATSから、すべての行が削除されます。詳細は、『Oracle TimesTen In-Memory Databaseシステム表およびビュー・リファレンス』の「SYS.TBL_STATS」および「SYS.COL_STATS」を参照してください。

必要な権限

このプロシージャには、表の所有者の権限は必要ありません。tblNameが指定されていない場合、このプロシージャに権限は必要ありません(これは、tblNameが指定されていない場合、このプロシージャは現在のユーザーの表に対して操作を行うためです)。

ユーザーが表の所有者でない場合、このプロシージャにはALTER ANY TABLE権限が必要です。

構文

ttOptClearStats('tblName', invalidate)

パラメータ

ttOptClearStatsには、次のパラメータがあります。

パラメータ

データ型

説明

tblName

TT_CHAR (61)

アプリケーション表の名前。表の所有者を含めることができます。tblNameが空の文字列であるか指定されていない場合、データベース内の現在のユーザーが所有するすべての表で統計が消去されます。
表名の指定にシノニムは使用できません。

invalidate

TT_INTEGER

0(no)または1(yes)。デフォルトは0です。
invalidateが1の場合、他のユーザーが準備したコマンドを含む、影響を受ける表を参照するすべてのコマンドは、再実行時に自動的に再準備されます。

invalidateが0の場合、統計は変更されたとはみなされず、既存のコマンドは再準備されません。

結果セット

ttOptClearStatsは結果を返しません。

例

CALL ttOptClearStats ( 'SALLY.ACCTS', 1 );

SALLY.ACCTS表の統計を消去し、ACCTS表に影響するすべてのコマンドを再準備します。

CALL ttOptClearStats();

現在のユーザーのすべての表の統計を消去し、これらの表に影響するすべてのコマンドを再準備します。

CALL ttOptClearStats('', 0);

現在のユーザーのすべての表の統計を消去しますが、これらの表に影響するコマンドは再準備しません。

関連項目

ttOptEstimateStats
ttOptSetColIntvlStats
ttOptSetFlag
ttOptSetOrder
ttOptSetTblStats
ttOptUpdateStats
ttPLSQLMemoryStats

ttOptCmdCacheInvalidate

説明

依存コマンドが再度呼び出された場合、この組込みプロシージャは、再コンパイルを強制するか、キャッシュからそのコマンドを削除します(ユーザーは再度それを準備する必要があります)。

このプロシージャは、次のような場合にコールします。

- すべての必要な統計を収集した後。

- 表のカーディナリティが大幅に変更された場合。

コマンドは、プロシージャによって再コンパイルが必要または無効としてマークされます。

コマンドの実行を停止するオプションはありません。

必要な権限

このプロシージャには、DDL権限が必要です。

構文

ttOptCmdCacheInvalidate('tblName', invalidate)

パラメータ

ttOptCmdCacheInvalidateには、次のパラメータがあります。

パラメータ

データ型

説明

tblname

TT_CHAR(61)

依存コマンドを無効化または再コンパイルする必要のある表の名前。

invalidate

TT_INTEGER

依存コマンドを強制的に再コンパイルまたは無効化します。
1: コマンドを再コンパイルする必要があることを示します。コマンドは、この組込みプロシージャのコール後の初回使用時に再コンパイルされます。(デフォルト)

2: コマンドを無効化する必要があることを示します。コマンドが再利用または再コンパイルされることはありません。無効化のマークを付けた後でコマンドをコールすると、TimesTenによってエラーが返されます。

結果セット

ttOptCmdCacheInvalidateは結果を返しません。

例

表tab1で依存コマンドを再コンパイルするには、次のように使用します。

CALL ttOptCmdCacheInvalidate ('tab1', 1);

表tab1で依存コマンドを無効化するには、次のように使用します。

CALL ttOptCmdCacheInvalidate ('tab1', 2);

関連項目

ttOptClearStats
ttOptEstimateStats
ttOptSetColIntvlStats
ttOptSetFlag
ttOptSetOrder
ttOptSetTblStats
ttOptUpdateStats
ttPLSQLMemoryStats

ttOptEstimateStats

説明

ttOptEstimateStatsプロシージャは、指定した表の統計を更新します。このプロシージャは、指定した表内の行をランダムにサンプリングすることによって統計を推定します。サンプルのサイズは、指定した行の数(sampleStrの形式がn ROWSの場合)または、行の総数の割合(sampleStrの形式がp PERCENTの場合)です。

tblNameが指定されていない場合、このプロシージャは現在のユーザーのすべての表に対して操作されます。

必要な権限

ユーザーが表の所有者である場合、またはtblNameが指定されていない場合、このプロシージャに権限は必要ありません。ユーザーが表の所有者でない場合、このプロシージャにはALTER ANY TABLE権限が必要です。

構文

ttOptEstimateStats(['tblName'], [invalidate], 'sampleStr')

パラメータ

ttOptEstimateStatsには、次のパラメータがあります。

パラメータ

データ型

説明

tblName

TT_CHAR(61)

アプリケーション表の名前。表の所有者を含めることができます。tblNameが空の文字列の場合、データベース内の現在のユーザーが所有するすべての表で統計が推定されます。
表名の指定にシノニムは使用できません。

invalidate

TT_INTEGER

0(いいえ)または1(はい)。invalidateが1の場合、他のユーザーが準備したコマンドを含む、影響を受ける表を参照するすべてのコマンドは、再実行時に自動的に再準備されます。invalidateが0の場合、統計は変更されたとはみなされず、既存のコマンドは再準備されません。
invalidateパラメータはオプションで、デフォルトは0です。

sampleStr

TT_VARCHAR (255) NOT NULL

n ROWSという形式の文字列(nは0(ゼロ)より大きい整数)、またはp PERCENTという形式の文字列(pは0.0から100.0の間の浮動小数点)。

結果セット

ttOptEstimateStatsは結果を返しません。

例

CALL ttOptEstimateStats ( 'ACCTS', 1, '5 PERCENT' );

CALL ttOptEstimateStats ( 'ACCTS', 1, '75 ROWS' );

注意

TimesTenの統計には、各表の行数、各列の一意の値の数、各列の最大値および最小値が含まれます。TimesTenでは、列の値の配分は均一であると想定しています。

このプロシージャは、表の行の50%より少ないサンプルで実行した場合にのみ、ttOptUpdateStatsよりも高速で実行されます。

2,048バイトを超える列の場合、推定は行われず、これらの列の統計は更新されません。2,048バイトを超える列の統計を更新するには、ttOptUpdateStats組込みプロシージャを使用します。可変長列の場合、このプロシージャによって更新されるのは、列の最大長が2,048バイト以下である場合の統計のみです。

sampleStrパラメータに非常に小さな値を選択した場合、このプロシージャは高速に実行されますが、実行計画は最適にはならない可能性があります。計画の正確性を低下させることなく、統計の計算を高速に実行し、適切なデータ分布を得るには、10%程度の選択が適しています。指定した行の数が十分であるか、または対象となる表が十分に小さい場合、TimesTenはパフォーマンスを向上させるために、長さが2,048バイト以下のすべての列に対して、正確な統計を計算します。たとえば、次の2つの相違点として、

ttOptEstimateStats ('ACCTS', 1, '100 PERCENT' )

と

ttOptUpdateStats( 'ACCTS', 1 )

前者が長い列の統計を計算しないということのみです。

統計は、システム表TBL_STATSおよびCOL_STATSに格納されます。

パフォーマンス上の理由から、ttOptEstimateStatsでは、統計が計算される際に表または行のロックは保持されません。統計の計算をそのように行った場合でも、パフォーマンスが低下する可能性があります。統計は、正確に計算するよりも推定した方が一般にパフォーマンスは向上します。

システム表を更新する権限がある場合、空の表リストを指定して統計を見積もり、または更新すると、システム表の統計も更新されます。

関連項目

ttOptSetColIntvlStats
ttOptSetFlag
ttOptSetOrder
ttOptSetTblStats
ttOptUpdateStats
ttPLSQLMemoryStats

ttOptGetColStats

説明

このプロシージャは、統計情報をテキスト形式で返します。

必要な権限

このプロシージャには、指定した表に対するSELECT権限が必要です。

構文

ttOptGetColStats('tblName', 'colName')

パラメータ

ttOptGetColStatsには、次のパラメータがあります。

パラメータ

データ型

説明

tblName

TT_CHAR (61)

統計情報が返される表の名前です。NULLが渡された場合、すべての表の値が返されます。
表名の指定にシノニムは使用できません。

colName

TT_CHAR (30)

統計が返される列の名前です。NULLが渡された場合、指定された表のすべての列の統計が返されます。

結果セット

ttOptGetColStatsは次の結果セットを返します。

列

データ型

説明

tblName

TT_CHAR (30)

表の名前。
表名の指定にシノニムは使用できません。

colName

TT_CHAR (30)

列の名前。

stats

TT_VARCHAR (409600) NOT NULL

テキスト形式の統計。

例

CALL ttOptGetColStats ();
< T1 , X1, (2, 10, 10, 100 (,4, 40, 10 ,1, 10, 5) ,
(4, 20, 20 ,11, 20, 15) )>

関連項目

ttOptSetColStats
ttOptSetColIntvlStats

ttOptGetFlag

説明

このプロシージャは、現在のトランザクションのオプティマイザ・フラグの設定を返します。結果はSQL SELECT文の結果と同様に、ODBC SQLFetch関数またはJDBC ResultSet.getXXX()メソッドを使用して取得できる結果セットとして返されます。アプリケーションはttOptGetFlagにフラグ名を渡すことによって、特定のオプティマイザ・フラグの値をリクエストできます。また、NULLを渡すことによって、すべてのオプティマイザ・フラグの値をリクエストすることもできます。オプティマイザ・フラグとそれらの意味については、ttOptSetFlag組込みプロシージャで説明します。

必要な権限

このプロシージャには、権限は必要ありません。

構文

ttOptGetFlag('flagName')

パラメータ

ttOptGetFlagには、次のパラメータがあります。

パラメータ

データ型

説明

flagName

TT_CHAR (32)

値が返されるフラグの名前です。NULLを渡した場合、すべてのフラグの値が返されます。

結果セット

ttOptGetFlagは次の結果セットを返します。

列

データ型

説明

flagName

TT_VARCHAR (32) NOT NULL

フラグの名前。有効なフラグの値については、「ttOptSetFlag」を参照してください。

value

TT_INTEGERNOT NULL

現在のフラグ値(0または1)。

例

CALL ttOptGetFlag('TmpHash');

関連項目

ttOptSetFlag

ttOptGetMaxCmdFreeListCnt

説明

このプロシージャは、コンパイル済SQLコマンド・キャッシュの空きリストのサイズを返します。キャッシュ・サイズをリセットするには、マテリアライズド・ビューについてはttOptSetMaxPriCmdFreeListCntを使用し、通常の表についてはttOptSetMaxCmdFreeListCntを使用します。

必要な権限

このプロシージャには、権限は必要ありません。

パラメータ

ttOptGetMaxCmdFreeListCntにパラメータはありません。

構文

ttOptGetMaxCmdFreeListCnt()

結果セット

ttOptGetMaxCmdFreeListCntは次の結果を返します。

列

データ型

説明

retVal

TT_VARCHAR (200) NOT NULL

コンパイル済SQLコマンドのキャッシュ・サイズ。

例

CALL ttOptGetMaxCmdFreeListCnt( );

関連項目

ttOptSetMaxPriCmdFreeListCnt
ttOptSetMaxCmdFreeListCnt

ttOptGetOrder

説明

このプロシージャは、現在のトランザクションの結合順序を含む、単一行の結果セットを返します。この結果セットは、SQL SELECT文の結果と同様に、ODBC SQLFetch関数またはJDBC ResultSet.getXXX()メソッドを使用して取得できます。結合順序については、ttOptSetOrder組込みプロシージャで説明します。

必要な権限

このプロシージャには、権限は必要ありません。

構文

ttOptGetOrder( )

パラメータ

ttOptGetOrderにパラメータはありません。

結果セット

ttOptGetOrderは次の結果セットを返します。

列

データ型

説明

joinOrder

TT_VARCHAR (1024) NOT NULL

現在のトランザクションのオプティマイザの結合順序。

例

CALL ttOptGetOrder;

関連項目

ttOptSetOrder

ttOptSetColIntvlStats

説明

このプロシージャは、時間隔情報を含む、指定した列の統計を変更します。このプロシージャを使用すると、TimesTenが自動的に統計を計算するのではなく、アプリケーションによって統計を手動で設定できます。この機能は、データが挿入される前にコマンドを準備したり、表の特性が実行計画の選択に与える影響を調べる場合に役立ちます。このプロシージャによって、COL_STATSシステム表の関連する行が変更されます。現在索引付けされていない列に対する時間隔統計の変更は無効です。

このプロシージャは表にデータが存在する前から使用できるため、基本的な妥当性チェックは実行されますが、指定する値は実際の値とは関係のないものでもかまいません。

必要な権限

このプロシージャには、所有者の場合は権限が必要ありませんが、所有者でない場合はALTER ANY TABLE権限が必要です。

構文

ttOptSetColIntvlStats('tblName', 'colName', invalidate, (stats))

パラメータ

ttOptSetColIntvlStatsには、次のパラメータがあります。

パラメータ

データ型

説明

tblName

TT_CHAR (61) NOT NULL

アプリケーション表の名前。表の所有者を含めることができます。表名の指定にシノニムは使用できません。

colName

TT_CHAR (30) NOT NULL

その表内の列の名前。

invalidate

TT_INTEGER

0(no)または1(yes)。invalidateが1の場合、影響を受ける表を参照するすべてのコマンドは、再実行時に自動的に再準備されます。このようなコマンドには、他のユーザーが準備したコマンドが含まれます。invalidateが0の場合、統計は変更されたとはみなされず、既存のコマンドは再準備されません。

stats

VARBINARY (409600) NOT NULL

次の形式を使用して、列のstatsを設定します。
(numInterval integer, numNull integer, totUniq integer, totTups integer,

/* information for interval 1 */

(numUniq integer, numTups integer, frequency of most occurred value integer, minVal, maxVal, modalVal),

/* information for interval 2 */...)

モーダル値(modalVal)とは、指定した時間隔で最も頻繁に出現する値です。

このパラメータは複合構造であるため、ODBC関数を使用してパラメータ化することも、ttIsql describeコマンドを使用して記述することもできません。たとえば、SQLPrepare(hstmt, "call ttOptSetColIntvlStats('t1', 'c1', 1, ?)", SQL_NTS))のような文は失敗します。

結果セット

ttOptSetColIntvlStatsは結果を返しません。

例

列t1.x1に次のような統計を設定します。

- 2つの時間隔

- 整数型

- 10行のNULL値

- 10の一意値

- 100行

- 時間隔1(最も頻繁に出現する値の他に4つの一意値、最も頻繁に出現する値以外の値を持つ40の行、最も頻繁に出現する値を持つ10の行、min = 1、max = 10、mod = 5)

- 時間隔2(最も頻繁に出現する値の他に4つの一意値、最も頻繁に出現する値以外の値を持つ20の行、最も頻繁に出現する値を持つ20の行、min = 11、max = 20、mod = 15)

この場合、次の文を実行します。

CALL ttOptSetColIntvlStats('t1', 'x1', 1, (2, 10, 10, 100,
(4, 40, 10, 1, 10, 5), (4, 20, 20, 11, 20, 15)));

注意

時間隔の最小値および最大値をVARBINARYとして指定する必要があります。NULL値を最小値または最大値として指定することはできません。値は、プラットフォーム固有のエンディアン形式で格納されます。

関連項目

ttOptEstimateStats
ttOptGetColStats
ttOptSetColStats
ttOptSetTblStats
ttOptUpdateStats

ttOptSetColStats

説明

このプロシージャは、指定した列の統計を変更します。このプロシージャを使用すると、TimesTenが自動的に統計を計算するのではなく、アプリケーションによって統計を手動で設定できます。この機能は、データが挿入される前にコマンドを準備したり、表の特性が実行計画の選択に与える影響を調べる場合に役立ちます。このプロシージャによって、COL_STATSシステム表の関連する行が変更されます。

このプロシージャは表にデータが移入される前から使用できるため、基本的な妥当性チェックは実行されますが、指定する値は実際の値とは関係のないものでもかまいません。

必要な権限

このプロシージャには、所有者の場合は権限が必要ありませんが、所有者でない場合はALTER ANY TABLE権限が必要です。

構文

ttOptSetColStats('tblName', 'colName', numUniq, minVal,maxVal,
invalidate, numNull)

パラメータ

ttOptSetColStatsには、次のパラメータがあります。

パラメータ

データ型

説明

tblName

TT_CHAR (61) NOT NULL

アプリケーション表の名前。表の所有者を含めることができます。
表名の指定にシノニムは使用できません。

colName

TT_CHAR (30) NOT NULL

その表内の列の名前。

num_Uniq

TT_INTEGERNOT NULL

列内の一意値の数。

minVal

VARBINARY(1024) NOT NULL

列内の最小値(切り捨てられる可能性あり)。

maxVal

VARBINARY(1024) NOT NULL

列内の最大値(切り捨てられる可能性あり)。

invalidate

TT_INTEGER

0(no)または1(yes)。invalidateが1の場合、影響を受ける表を参照するすべてのコマンドは、再実行時に自動的に再準備されます。このようなコマンドには、他のユーザーが準備したコマンドが含まれます。invalidateが0の場合、統計は変更されたとはみなされず、既存のコマンドは再準備されません。

num_Null

TT_INTEGER

列のNULLの総数を指定します。

結果セット

ttOptSetColStatsは結果を返しません。

例

CALL ttOptSetColStats ('SALLY.ACCTS, 'BALANCE, 400,
0x00001388, 0x000186A0, 1, 0);

注意

最小値および最大値をVARBINARYとして指定する必要があります。NULL値を最小値または最大値として指定することはできません。値は、プラットフォーム固有のエンディアン形式で格納されます。

統計は、最小値と最大値の間に均一に配分されている列値の、単一の時間隔として処理されます。

関連項目

ttOptEstimateStats
ttOptGetColStats
ttOptSetColIntvlStats
ttOptSetTblStats
ttOptUpdateStats

ttOptSetFlag

説明

このプロシージャは、アプリケーションで、TimesTen問合せオプティマイザによる実行計画の生成を変更できるようにします。フラグを設定して、様々なアクセス方法の使用を有効または無効にします。このコールによって加えられた変更は、文を準備するときに有効になり、それ以降に現在のトランザクションで実行される、ODBC関数SQLPrepareおよびSQLExecDirectへのすべてのコール、またはJDBCメソッドConnection.prepareCallおよびStatement.executeへのすべてのコールが影響を受けます。オプティマイザのすべてのフラグは、トランザクションがコミットまたはロールバックされた時点でそれぞれのデフォルト値にリセットされます。AutoCommitがオンのときにオプティマイザ・フラグセットされた場合、それらは無視されます。

必要な権限

このプロシージャには、権限は必要ありません。

構文

ttOptSetFlag('optFlag', optVal)

パラメータ

ttOptSetFlagには、次のパラメータがあります。

パラメータ

データ型

説明

optFlag

TT_CHAR (32) NOT NULL

オプティマイザ・フラグの名前。

optVal

TT_INTEGERNOT NULL

オプティマイザ・フラグの値。次の「オプティマイザ・フラグ」に記載されている場合を除き、通常、値は0(無効/禁止)または1(有効/許可)です。

オプティマイザ・フラグ

オプティマイザ・フラグを設定する場合は、次の文字列を使用します。大文字と小文字は区別されません。

フラグ

説明

BranchAndBound

ブランチおよびバインドされた最適化を有効または無効にします。有効な場合、TimesTenによって、最適化プロセスの冒頭の0フェーズで、問合せ計画の最大コストが計算されます。無効な場合、TimesTenはこのコスト分析を実行しません。

DynamicLoadEnable

Oracle DatabaseからTimesTenの動的キャッシュ・グループへのデータの動的ロードを有効または無効にします。デフォルトでは、Oracle Databaseからのデータの動的ロードが有効になっています。

DynamicLoadErrorMode

動的ロード・エラー・モードを有効または無効にします。このモードにより、TimesTen動的キャッシュ・グループに対する透過的ロード処理が失敗した場合のエラー・メッセージの出力が制御されます。デフォルトでは無効です。

FirstRow

SELECT、UPDATEまたはDELETE文の最初の行の最適化を有効または無効にします。SQLキーワードのFIRSTがSQL文で使用された場合、これはオプティマイザ・ヒントより優先されます。キーワードFIRSTは、最初の行の最適化を有効にします。

ForceCompile

強制コンパイルを有効または無効にします。有効な場合、TimesTenは問合せを再コンパイルし、毎回、問合せ計画を再生成します。無効な場合、問合せ計画が使用可能な場合でも、TimesTenはコンパイルを実行しません。

GenPlan

残りのトランザクションでのPLAN表のエントリの作成を有効または無効にします。
例については、『Oracle TimesTen In-Memory Databaseオペレーション・ガイド』のシステムPLAN表に計画を保存するようにTimesTenに指示する方法に関する説明を参照してください。

GlobalLocalJoin

グリッドに結合を含むSELECTおよびUNLOAD CACHE GROUP文のグローバル実行を有効または無効にします。デフォルトでは、これらの文はローカルで実行されます。
0: SELECTおよびUNLOAD CACHE GROUP文、ならびに結合のいずれもローカルで実行されます。

1: SELECTおよびUNLOAD CACHE GROUP文はグローバルで実行され、結合はローカルで実行されます。

詳細は、『Oracle TimesTen Application-Tier Database Cacheユーザーズ・ガイド』を参照してください。

GlobalProcessing

グリッドのSELECTおよびUNLOAD CACHE GROUP文のグローバル実行を有効または無効にします。デフォルトでは、これらの文はローカルで実行されます。
0 - SELECTおよびUNLOAD CACHE GROUP文はローカルで実行されます。

1 - SELECTおよびUNLOAD CACHE GROUP文はグローバルで実行されます。

詳細は、『Oracle TimesTen Application-Tier Database Cacheユーザーズ・ガイド』を参照してください。

Hash

索引付けされた表スキャンで、既存のハッシュ索引の使用を有効または無効にします。

HashGb

ハッシュ・グループの使用を有効または無効にします。

IndexedOR

シリアライズ表スキャンを有効または無効にします。無効な場合、TimesTenはIN...リスト条件にシリアライズ表スキャンを使用し、それ以外の場合はOR条件に複数索引スキャンを使用します。

MergeJoin

マージ結合の使用を有効または無効にします。

NestedLoop

2つの表を結合する一般的な方法を示します。

NoRemRowIdOpt

RowIDの内部生成を有効または無効にします。有効な場合、最適化が目的でRowIDが内部的に生成されることはありません。無効な場合、行がSELECTリストにない場合でも、RowIDは内部的に生成されます。

PassThrough

TimesTen Cacheアプリケーションのパススルー・レベルを一時的に変更します。パススルー・レベルはいつでも設定が可能で、変更はただちに有効になります。このフラグの有効な値は次のとおりです。
0 (デフォルト): SQL文はTimesTenに対してのみ実行されます。

1: TimesTen以外の1つ以上の表を参照していないかぎり、INSERT、UPDATEおよびDELETE文はTimesTenに対して実行されます。TimesTen以外の1つ以上の表を参照している場合は、Oracle Databaseに渡されます。DDL文はTimesTenに対して実行されます。その他の文がTimesTenで構文エラーを生成する場合、またはその他の文で参照されている1つ以上の表がTimesTenに存在しない場合に、その他の文はOracle Databaseに渡されます。

2: 読取り専用キャッシュ・グループまたはREADONLYキャッシュ表属性を持つユーザー管理キャッシュ・グループの表に対して実行されたINSERT文、UPDATE文およびDELETE文は、Oracle Databaseに渡されます。その他のキャッシュ・グループ・タイプに対するパススルー動作は、PassThrough=1と同じです。

3: TimesTenエラーとなる動的AWTグローバル・キャッシュ・グループのキャッシュ表に対して実行されるINSERT、UPDATEおよびDELETE文を除いて、すべての文はOracle Databaseに渡されて実行されます。

4: 動的ロードの問合せの基準を満たさない動的AWTグローバル・キャッシュ・グループのキャッシュ表に対して実行されたSELECT文は、Oracle Databaseに渡されて実行されます。これ以外の場合、文はTimesTenデータベースで実行されます。

5: 接続中の以前のトランザクションによって、動的AWTグローバル・キャッシュ・グループのキャッシュ表でコミットされたすべての更新がOracle Databaseに伝播されるときに、動的ロード問合せの基準を満たさない動的AWTグローバル・キャッシュ・グループのキャッシュ表に対して実行されたSELECT文はOracle Databaseに渡されて実行されます。これ以外の場合、文はTimesTenデータベースで実行されます。

Range

索引付けされた表スキャンで、既存の範囲索引の使用を有効または無効にします。

Rowid

Row IDの使用を有効または無効にします。

RowLock

オプティマイザによる行ロックの使用を許可または禁止します。

Scan

全表スキャンを示します。

ShowJoinOrder

オプティマイザ・スキャンでの表の結合順序を表示します。

TblLock

オプティマイザによる表ロックの使用を有効または無効にします。

TmpHash

一時的なハッシュ・スキャンの使用を有効または無効にします。これは、文の評価で使用するために実行時に作成される索引です。索引の作成には時間がかかりますが、結合条件を評価する場合の時間を節約できます。

TmpRange

一時的な範囲スキャンを実行します。また、マージ結合で値をソートするためにも使用できます。索引の作成には時間がかかりますが、結合条件を評価する場合の時間を節約できます。

TmpTable

中間結果を一時表に格納します。この処理は、結合問合せでの条件の評価を繰り返し実行することを回避したり、結合における中間結果のスキャンを単に高速化するために選択されることもあります。

UseBoyerMooreStringSearch

Boyer-Moore文字列検索アルゴリズムを有効または無効にします。有効な場合、Boyer-Moore文字列検索アルゴリズムが有効になります。これによって、LIKE演算子のパフォーマンスを改善できます。

さらに文字列AllFlagsをすべてのオプティマイザ・フラグを参照するために使用し、文字列Defaultをデフォルトのフラグを参照するために使用できます。Defaultには、GenPlanフラグ以外のすべてのオプティマイザ・フラグが含まれます。

フラグの説明

各フラグの値は1または0です。

- 1の場合、処理は有効

- 0の場合、必要時以外、処理は無効

GenPlan以外のすべての初期フラグ値は1です(すべての処理が許可されます)。

たとえば、アプリケーションで、中間結果を格納する計画をオプティマイザが選択できないようにできます。

ttOptSetFlag ( 'TmpTable', 0 )

同様に、アプリケーションでMergeJoinのプリファレンスを指定できます。

ttOptSetFlag ( 'MergeJoin', 0 )

2つ目の例では、マージ結合が不可能な場合(たとえば、マージ結合条件がない場合)、オプティマイザはネステッド・ループ・ジョインを選択できます。同様に、オプティマイザが、表スキャンを回避するアプリケーション・リクエストを満たすことができない場合もあります(Scanフラグが0に設定されている場合)。

特定の処理が特定の計画手順で禁止されると指定すること、または特定の2つの表では必ず特定の結合方法が使用されると指定することはできません。同様に、特定の索引が使用されると指定すること、または特定の条件を評価するためにハッシュ索引が使用されると指定することもできません。各処理は、完全に許可されているか、完全に制限されているかのいずれかです。

コマンドが準備されている場合は、現在のオプティマイザ・フラグ、索引ヒントおよび結合順序はコマンドのコンパイル済形式の構造で保持され、システムによってそのコマンドが再準備されるときに使用されます。再準備された文の例については、『Oracle TimesTen In-Memory Databaseオペレーション・ガイド』のTimesTen問合せオプティマイザに関する説明を参照してください。

RowLock およびTblLockの両方が無効な場合、TimesTenでは行ロックが使用されます。RowLockおよびTblLockの両方が有効な場合、TimesTenでは、パフォーマンスがより高い方のロック・スキームが使用されます。

TblLockの状態

RowLockの状態

オプティマイザへの影響

無効

無効

行レベル・ロックの使用。

有効

無効

表レベル・ロックの使用。

無効

有効

行レベル・ロックの使用。

有効

有効

行レベル・ロックまたは表レベル・ロックをオプティマイザが選択します。

通常、問合せによって表の行の重要な部分がアクセスされる場合、またはその表に同時アクセスしているトランザクションの数が非常に少ない場合に、表レベル・ロックは有効です。

結果セット

ttOptSetFlagは結果を返しません。

例

CALL ttOptSetFlag ('TmpHash', 1);

注意

結合の順序は、特定のSQL文の中で文レベル・オプティマイザ・ヒントを使用して設定することもできます。詳細は、『Oracle TimesTen In-Memory Database SQLリファレンス・ガイド』の文レベル・オプティマイザ・ヒントに関する説明を参照してください。特にヒントの各スタイルの動作を理解するには、文レベルとトランザクション・レベルのオプティマイザ・ヒントの違いに関する表を参照してください。

関連項目

ttOptEstimateStats
ttOptGetFlag
ttOptGetOrder
ttOptSetColIntvlStats
ttOptSetOrder
ttOptSetTblStats
ttOptUpdateStats
ttPLSQLMemoryStats

ttOptSetMaxCmdFreeListCnt

説明

このプロシージャは、通常の表に対するコンパイル済SQLコマンドの空きリストの最大カウントを設定します。現在の設定値を取得するには、ttOptGetMaxCmdFreeListCntプロシージャを使用します。

必要な権限

このプロシージャには、ADMIN権限が必要です。

構文

ttOptSetMaxCmdFreeListCnt(maxCnt)

パラメータ

ttOptSetMaxCmdFreeListCntには、次の必須のパラメータがあります。

パラメータ

データ型

説明

maxCnt

TT_INTEGERNOT NULL

通常の表に対するコンパイル済SQL空きコマンドの最大数。

結果セット

ttOptSetMaxCmdFreeListCntは結果を返しません。

例

CALL ttOptSetMaxCmdFreeListCnt(40);

関連項目

ttOptGetMaxCmdFreeListCnt

ttOptSetMaxPriCmdFreeListCnt

説明

このプロシージャは、マテリアライズド・ビューのメンテナンスを実行するコンパイル済SQLコマンドの空きリストの最大カウントを設定します。

このコマンドを設定すると、解放可能なコンパイル済マテリアライズド・ビュー・コマンドは通常の表とは別にカウントされます。このコマンドを設定しない場合、コンパイル済マテリアライズド・ビュー・コマンドは通常のコマンドとしてカウントされます。

必要な権限

このプロシージャには、ADMIN権限が必要です。

構文

ttOptSetMaxCmdPriFreeListCnt(maxCnt)

パラメータ

ttOptSetMaxPriCmdFreeListCntには、次の必須のパラメータがあります。

パラメータ

データ型

説明

maxCnt

TT_INTEGERNOT NULL

コンパイル済SQLコマンドのキャッシュ・サイズ。

結果セット

ttOptSetMaxPriCmdFreeListCntは結果を返しません。

例

CALL ttOptSetMaxPriCmdFreeListCnt(40);

関連項目

ttOptGetMaxCmdFreeListCnt
ttOptSetMaxCmdFreeListCnt

ttOptSetOrder

説明

このプロシージャは、オプティマイザが表を結合する順序を指定します。文字列は、カンマではなく空白で区切られた表名または表の相関名のリストで、問合せまたは副問合せで参照されます。最初にリストされている表が、計画によって最初にスキャンされます。たとえば、ネステッド・ループ結合では一番外側になります。相関名は、修飾された表名のショートカットまたは別名です。この組込みプロシージャの実行中は、AutoCommitをOFFに設定する必要があります。

必要な権限

このプロシージャには、権限は必要ありません。

構文

ttOptSetOrder('joinOrder')

パラメータ

ttOptSetOrderには、次の必須のパラメータがあります。

パラメータ

データ型

説明

join_Order

TT_VARCHAR(1024)

空白で区切られた表名または表相関名のリスト。表名を区別するために所有者が必要な場合は、表相関名を使用します。joinOrderを指定しない場合、問合せオプティマイザの動作はデフォルトに戻ります。

結果セット

ttOptSetOrderは結果を返しません。

例

CALL ttOptSetOrder ('EMPS DEPTS ACCTS');

アプリケーションが次のコールを実行するとします。

call ttOptSetOrder('ORDERS CUSTOMERS');

オプティマイザは、1つ以上の未出荷注文を持つすべての顧客を表示する次の問合せを評価する際に、CUSTOMERSをスキャンする前に、ORDERS表をスキャンします。

SELECT CUSTOMERS.NAME
FROM  CUSTOMERS
WHERE EXISTS (SELECT 1
FROM  ORDERS
WHERE CUSTOMERS.ID = ORDERS.CUSTID
AND  ORDER.STATUS ='UN-SHIPPED');

アプリケーションが次のコールを実行するとします。

ttOptSetOrder('DEPTS EMPS ACCTS');

オプティマイザは、特定のアカウントで働いている従業員の数を評価する際に、DEPTSとACCTSの間で結合を実行することはできません。

SELECT COUNT(DISTINCT EMPS.ID)
FROM  ACCTS, DEPTS, EMPS
WHERE ACCTS.DEPTS = DEPTS.ID
AND  EMPS.DEPTS = DEPTS.ID
AND  ACCTS.NUM = :AcctNum

アプリケーションで、結合順序をリセットせずに、3つの各表を参照しないコマンドを準備しようとすると、オプティマイザによって警告番号965が発行されます。指定した結合順序は適用されません。TimesTenでは、コマンドが準備される際、有効な結合順序が考慮され、指定した結合順序は無視されます。

注意

結合順序では、導出された表の別名はサポートされていません。表の別名を指定すると、TimesTenによって、その順序は適用できないことを示す警告メッセージ965が返されます。

文字列の長さは1,024バイトに制限されています。文字列がこの長さを超えると、切り捨てられ、警告が発行されます。

副問合せで参照される相関名が結合順序に含まれていると、TimesTenでは、内部的に分離モードに切り替えられます。

コマンドが準備されている場合は、現在のオプティマイザ・フラグ、索引ヒントおよび結合順序はコマンドのコンパイル済形式の構造で保持され、システムによってそのコマンドが再準備されるときに使用されます。再準備された文の例については、『Oracle TimesTen In-Memory Databaseオペレーション・ガイド』のTimesTen問合せオプティマイザに関する説明を参照してください。

このコールによって加えられた変更はただちに有効になり、現在のトランザクションでのODBC関数SQLPrepareまたはJDBCメソッドConnection.prepareCallへの後続のすべてのコールに影響します。後続のトランザクションに備えて、問合せオプティマイザの動作はデフォルトに戻ります。

結合順序を使用する場合、問合せによって参照される表の名前は、指定した名前と厳密に一致している必要があります(比較では大文字と小文字が区別されません)。部分的な順序を指定するメカニズムはないため、完全な順序を指定する必要があります。問合せに副問合せがある場合、結合順序は副問合せの中の相関名も参照する必要があります。つまり、結合順序は問合せの中のすべての相関名を参照する必要があります。TimesTenオプティマイザは、GROUP BYを使用して、特別な種類の結合問合せとして副問合せを内部的に実装します。結合順序を適用可能にするには、すべての相関名を参照する必要があります。矛盾がある場合はTimesTenでは警告が発行され、指定した結合順序は完全に無視されます。

結合の順序は、特定のSQL文の中で文レベル・オプティマイザ・ヒントを使用して設定することもできます。詳細は、『Oracle TimesTen In-Memory Database SQLリファレンス・ガイド』の文レベル・オプティマイザ・ヒントに関する説明を参照してください。特にヒントの各スタイルの動作を理解するには、文レベルとトランザクション・レベルのオプティマイザ・ヒントの違いに関する説明を参照してください。

関連項目

ttOptEstimateStats
ttOptGetFlag
ttOptGetOrder
ttOptSetColIntvlStats
ttOptSetFlag
ttOptSetTblStats
ttOptUpdateStats
ttPLSQLMemoryStats

ttOptSetTblStats

説明

このプロシージャは、指定した表の統計を変更します。このプロシージャを使用すると、TimesTenが自動的に統計を計算するのではなく、アプリケーションで明示的に統計を設定できます。

必要な権限

このプロシージャには、所有者の場合は権限が必要ありませんが、所有者でない場合はALTER ANY TABLE権限が必要です。

構文

ttOptSetTblStats('tblName', numRows, invalidate)

パラメータ

ttOptSetTblStatsには、次のパラメータがあります。

パラメータ

データ型

説明

tblName

TT_CHAR (61) NOT NULL

アプリケーション表の名前。表の所有者を含めることができます。
表名の指定にシノニムは使用できません。

num_Rows

TT_INTEGERNOT NULL

表の行数。

invalidate

TT_INTEGER

0(no)または1(yes)。invalidateが1の場合、他のユーザーが準備したコマンドを含む、影響を受ける表を参照するすべてのコマンドは、再実行時に自動的に再準備されます。invalidateが0の場合、統計は変更されたとはみなされず、既存のコマンドは再準備されません。

結果セット

ttOptSetTblStatsは結果を返しません。

例

CALL ttOptSetTblStats ( 'ACCTS', 10000, 0 );

注意

この機能は、データが挿入される前にコマンドを準備したり、表サイズが実行計画の選択に与える影響を調べる場合に役立ちます。コマンドは表にデータが存在する前から使用できるため、指定する値は実際の値とは関係のないものでもかまいません。このプロシージャによって、TBL_STATSシステム表の関連する行が変更されます。『Oracle TimesTen In-Memory Databaseシステム表およびビュー・リファレンス』のSYS.TBL_STATSに関する説明を参照してください。

関連項目

ttOptEstimateStats
ttOptGetFlag
ttOptGetOrder
ttOptSetColIntvlStats
ttOptSetFlag
ttOptSetOrder
ttOptUpdateStats
ttPLSQLMemoryStats

ttOptShowJoinOrder

説明

このプロシージャは、現在のトランザクションで最後に準備または実行されたSQL文(SELECT、UPDATE、DELETEおよびINSERT SELECT)の結合順序を返します。結合順序を収集するには、同じトランザクションで、まずttOptSetFlag('ShowJoinOrder', 1)を使用するか、ttIsqlのShowJoinOrderコマンドをON (1)に設定します。これらのコマンドのいずれかを使用するときは、AUTOCOMMITをオフにしておいてください。結合順序は、表の名前の順序によって表されます。

必要な権限

このプロシージャには、権限は必要ありません。

構文

ttOptShowJoinOrder()

パラメータ

ttOptShowJoinOrderにパラメータはありません。

結果セット

ttOptShowJoinOrderは次の結果を返します。

列

データ型

説明

joinOrder

TT VARCHAR (4096) NOT NULL

表名(指定されている場合は、所有者名の修飾子および各表の相関名が含まれます)。表名は、カッコで囲まれて返されます。
表名の指定にシノニムは使用できません。

例

>AUTOCOMMIT 0;
> CALL ttOptSetFlag ('ShowJoinOrder', 1);
>PREPARE SELECT * FROM t1;
>CALL ttOptShowJoinOrder();
>( T1 )

注意

このプロシージャを使用する前に、ttOptSetFlag('ShowJoinOrder', 1)をコールするか、ttIsqlのShowJoinOrderコマンドをON (1)に設定する必要があります。

このプロシージャは、1つのトランザクション内で正しく動作します。複数のトランザクション間では正しく動作しません。

関連項目

ttOptEstimateStats
ttOptGetFlag
ttOptGetOrder
ttOptSetColIntvlStats
ttOptSetFlag
ttOptSetOrder
ttOptSetTblStats
ttOptUpdateStats
ttPLSQLMemoryStats

ttOptStatsExport

説明

このプロシージャは、表の統計を現在の状態にリストアするために必要な一連の文を返します。表が指定されていない場合は、コールするユーザーがアクセス権を持つすべてのユーザー表の表統計をリストアするために必要な一連の文を返します。

必要な権限

このプロシージャを実行するにはADMIN権限が必要です。

構文

ttOptStatsExport('tblName')

パラメータ

ttOptStatsExportには次のパラメータがあります。

パラメータ

データ型

説明

tblName

TT_CHAR(61) NOT NULL

統計情報が返される表の名前です。NULLが渡された場合、すべての表の値が返されます。
表名の指定にシノニムは使用できません。

結果セット

ttOptStatsExportは次の結果セットを返します。

列

データ型

説明

stmt

TT_VARCHAR (8300) NOT NULL

表の統計を現在の状態にリストアするために必要な一連の文。

例

CALL ttOptStatsExport('MyTable');

関連項目

『Oracle TimesTen In-Memory Databaseオペレーション・ガイド』の現在の表統計を再生成するスクリプトの作成に関する説明。

ttOptUpdateStats

説明

このプロシージャは、指定した表の統計を更新します。TimesTenは表に格納されているデータを参照して、システム表TBL_STATSおよびCOL_STATSを更新します。表が大きい場合、このプロセスには多少時間がかかる可能性があります。行が更新されても統計は自動的に計算されないため、このプロシージャをコールすることによって、アプリケーションで明示的に統計を計算する必要があります。

tblNameが指定されていない場合、このプロシージャは現在のユーザーのすべての表に対して操作されます。

必要な権限

ユーザーが表の所有者である場合、またはtblNameが指定されていない場合、このプロシージャに権限は必要ありません。ユーザーが表の所有者でない場合、このプロシージャにはALTER ANY TABLE権限が必要です。

構文

ttOptUpdateStats(['tblName'], [invalidate], [option])

パラメータ

ttOptUpdateStatsには、次のパラメータがあります。

パラメータ

データ型

説明

tblName

TT_CHAR(61)

アプリケーション表の名前。表の所有者を含めることができます。NULLまたは空の文字列を値として指定すると、現在のユーザーのすべての表の統計が更新されます。
表名の指定にシノニムは使用できません。

invalidate

TT_INTEGER

0(いいえ)または1(はい)。invalidateが1の場合、ALTER TABLE DROP TABLE文とALTER TABLE ADD COLUMN FOR SELECT * FROM TABLE文以外のすべてのコマンドが、次の実行時に再準備するようにマークされます。これらの例外については、手動で再準備する必要があります。invalidateが0の場合、統計は変更されたとはみなされず、既存のコマンドは再準備されません。
invalidateパラメータはオプションで、デフォルトは0です。

option

TT_INTEGER

完全な時間隔の統計情報の収集をするかどうかを指定します。このオプションに有効な値は、次のとおりです。
NULLまたは0: 列に範囲索引が存在する場合にのみ、完全な時間隔統計を収集します。範囲索引が存在しない場合は、単一の時間隔統計を収集します。

1 - 完全な時間隔統計を収集しません。単一の時間隔統計のみが収集されます。

optionパラメータはオプションで、デフォルトは0です。

詳細は、次の注意を参照してください。

結果セット

ttOptUpdateStatsは結果を返しません。

例

CALL ttOptUpdateStats ( 'ACCTS', 1 );

ACCTS表を更新し、ACCTS表を参照するすべてのコマンドを次回の実行時に再準備します。

CALL ttOptUpdateStats('', 1);

現在のユーザーのすべての表を更新し、その表に対するコマンドを次回の実行時に再準備します。

CALL ttOptUpdateStats('ACCTS', 0, 1);

単一の時間隔統計を収集します。

注意

指定した表名が空の文字列である場合、統計は現在のユーザーのすべての表について更新されます。

完全な時間隔統計を収集する場合、表の列の総数は20以下の時間隔に分割され、各時間隔の配分が統計に記録されます。新しい統計には、次の情報が含まれます。

- 時間隔の数

- 列のNULL値の総数

- 列のNON NULL UNIQUE値の総数

- 表の行の総数

- 時間隔情報(各時間隔には次の情報が含まれます)

- 最小値

- 最大値

- 最大頻度の値

- 最大頻度の値の数

- 最大頻度の値と異なる値の行の数

- 最大頻度の値以外の一意値の数

完全な時間隔統計を収集するには、データをソートする必要があります。

完全な時間隔統計を選択しない場合、全体の配分を単一の時間隔として処理することにより、統計が収集されます。

TimesTenでは、パフォーマンス上の理由から、統計の計算時に表ロックおよび行ロックは保持されません。ただし、統計の計算をそのように行った場合でも、パフォーマンスが低下する可能性があります。統計は、正確に計算するよりも推定した方が一般にパフォーマンスは向上します。統計の推定については、「ttOptEstimateStats」を参照してください。

システム表を更新する権限がある場合、空の表リストを指定して統計を見積もり、または更新すると、システム表の統計も更新されます。

関連項目

ttOptEstimateStats
ttOptGetColStats
ttOptSetColStats
ttOptSetColIntvlStats
ttOptSetTblStats
ttOptUpdateStats

ttOptUseIndex

説明

このプロシージャは、アプリケーションで、TimesTen問合せオプティマイザによる実行計画の生成を変更できるようにします。アプリケーションはこのプロシージャをコールして、一連の索引の使用を無効にしたり、問合せで使用する各相関関係のために一連の索引のみの使用を有効にすることができます。索引の使用を有効にしても、生成された計画がその索引を使用するとはかぎりません。オプティマイザは、推定されたコストに応じて、指定した索引を使用する計画より優れた計画が得られる場合、シリアライズ・スキャンまたはマテリアライズ・スキャンを使用して、関連する相関関係にアクセスすることを選択する場合があります。

このコールによって加えられた変更はただちに有効になり、アプリケーションがこれを消去するコールを明示的に発行するまで、現在のトランザクションでのODBC関数SQLPrepareおよびSQLExecDirectへの後続のすべてのコール、JDBCメソッドConnection.prepareCallおよびStatement.executeへの後続のすべてのコールに影響します。新しいトランザクションが開始されるたびに、設定は消去されます。

この組込みプロシージャの実行中は、AutoCommitをOFFに設定する必要があります。

必要な権限

このプロシージャには、権限は必要ありません。

構文

ttOptUseIndex('IndexName, CorrelationName, 0 | 1 [;...]')

パラメータ

ttOptUseIndexには、次の構成要素を持つTT_VARCHAR(1024)型の単一のカンマで区切られた文字列パラメータindOptionがあります。

構成要素

説明

IndexName

ユーザー定義索引の名前(一時的な範囲索引の場合は「_TMPRANGE」、一時的なハッシュ索引の場合は「_TMPHASH」)。索引名を省略すると、指定した相関関係のすべての索引に設定が適用されます。

CorrelationName

表の相関名。表がFROM句の相関名によって定義されている場合、この表の索引ヒントを指定する際は、表名のかわりにこの相関名を使用します。相関名を省略すると、この設定は、指定した索引名を持つすべての表に影響します。

0 | 1

IndexNameで指定した索引の使用を無効(0)または有効(1)にします。

結果セット

ttOptUseIndexは結果を返しません。

例

CALL ttOptUseIndex('"3456"."1234", t1, 0');

CALL ttOptUseIndex('data1.i1, data1.t1, 0');

CALL ttOptUseIndex('i1, t1, 0');

注意

パラメータを指定しないか、またはNULL値を指定してttOptUseIndexをコールすると、前の索引ヒントが消去されます。

関連項目

ttOptEstimateStats
ttOptGetFlag
ttOptGetOrder
ttOptSetColIntvlStats
ttOptSetFlag
ttOptSetOrder
ttOptSetTblStats
ttOptUpdateStats
ttPLSQLMemoryStats

ttPLSQLMemoryStats

説明

このプロシージャは、PL/SQLライブラリ・キャッシュのパフォーマンスおよびアクティビティに関する結果統計を返します。

必要な権限

このプロシージャには、権限は必要ありません。

構文

ttPLSQLMemoryStats( )

パラメータ

ttPLSQLMemoryStatsにパラメータはありません。

結果セット

ttPLSQLMemoryStatsは、次の列に結果を返します。

列

データ型

説明

paramName

TT_VARCHAR (30) NOT NULL

この行に返された結果統計の名前。

paramValue

BINARY_FLOAT NOT NULL

この行に返された結果統計の値。

次の統計が返されます。

- Gets: PL/SQLオブジェクトに対してロックがリクエストされた回数。

- GetHits: PL/SQLオブジェクトのハンドルがメモリーで検出された回数。

- GetHitRatio: Getsに対するGetHitsの比率。

- Pins: PL/SQLオブジェクトに対してPINがリクエストされた回数。

- PinHits: ライブラリ・オブジェクトのすべてのメタデータ・ピースがメモリーで検出された回数。

- PinHitRatio: Pinsに対するPinHitsの比率。

- Reloads: オブジェクトのPINのうち、オブジェクト・ハンドルの作成後初めて実行されたPINではなく、データベースからのオブジェクトのロードを必要とするPIN。

- Invalidations: 依存オブジェクトが変更されたためにこのネームスペースのオブジェクトが無効とマークされた合計回数。

- CurrentConnectionMemory: このデータベース接続でPL/SQLに割り当てられるヒープ・メモリーの総量(MB単位)。

- DeferredCleanups: 遅延クリーンアップが発生した合計回数。

例

connect "DSN=sample";
Connection successful:
DSN=sample;UID=timesten;DataStore=/scratch/timesten/sample;
DatabaseCharacterSet=AL32UTF8;ConnectionCharacterSet=AL32UTF8;
PermSize=128;TypeMode=0;PLSQL_MEMORY_SIZE=32;
PLSQL_MEMORY_ADDRESS=20000000;PLSQL=1;(Default setting AutoCommit=1)
Command> create procedure hello is begin
dbms_output.put_line('Hello, World!');
end;
> /
Procedure created.
Command> call ttPlsqlMemoryStats;
< Gets, 485.00000 >
< GetHits, 444.000000 >
< GetHitRatio, .9154639 >
< Pins, 260.00000 >
< PinHits, 178.000000 >
< PinHitRatio, .6846154 >
< Reloads, 4.000000 >
< Invalidations, 0.000000e+00 >
< CurrentConnectionMemory, 56.00000 >
9 rows found.

ttRamPolicyAutoReloadGet

説明

このプロシージャは、無効化の後、データベースがRAMにリロードされるかどうかを判断するために使用するRAM自動リロード・ポリシーを返します。ポリシーは、autoreloadまたはnoautoreloadのいずれかです。

必要な権限

このプロシージャには、権限は必要ありません。

構文

ttRamPolicyAutoReloadGet()

結果セット

ttRamPolicyAutoReloadGetは次の結果を返します。

列

データ型

説明

flag

TT_INTEGER

無効化の後、データベースがRAMにリロードされるかどうかを判断するために使用するポリシー。有効な値は、次のとおりです。
0 - 無効化の後、データベースが自動的にメモリーにリロードされることはありません。これは、コマンドttAdmin -noAutoReloadと等価です。

1 - 無効化の後、データベースは自動的にメモリーにリロードされます。これは、コマンドttAdmin -autoReloadと等価です。これは、デフォルトの自動リロード・ポリシーです。

パラメータ

ttRamPolicyAutoReloadGetにパラメータはありません。

例

RAM自動リロード・ポリシーを表示するには、次のように使用します。

CALL ttRamPolicyAutoReloadGet();

関連項目

ttRamPolicyAutoReloadSet
「ttAdmin」

ttRamPolicyAutoReloadSet

説明

このプロシージャは、データベースが無効化されている場合にRAM自動リロード・ポリシーを判断します。ポリシーは、autoreloadまたはnoautoreloadのいずれかです。

必要な権限

このプロシージャには、ADMIN権限が必要です。

構文

ttRamPolicyAutoReloadSet(flag)

パラメータ

ttRamPolicyAutoReloadSetには、次のパラメータがあります。

パラメータ

データ型

説明

flag

TT_INTEGERNOT NULL

無効化の後、データベースがRAMにリロードされるかどうかを判断するために使用するポリシー。有効な値は、次のとおりです。
0 - 無効化の後、データベースが自動的にメモリーにリロードされることはありません。これは、コマンドttAdmin -noAutoReloadと等価です。

1 - 無効化の後、データベースは自動的にメモリーにリロードされます。これは、コマンドttAdmin -autoReloadと等価です。これは、デフォルトの自動リロード・ポリシーです。

結果セット

ttRamPolicyAutoReloadSetは結果を返しません。

例

無効化の後、データベースを自動的にRAMにリロードするには、次のように使用します。

CALL ttRamPolicyAutoReloadSet(1);

関連項目

ttRamPolicyAutoReloadGet
「ttAdmin」

ttRamPolicyGet

説明

このプロシージャは、データベースがメモリーにロードされるタイミングを決定するRAMポリシーを返します。ポリシーは、always、manual、inUseのいずれかです。

必要な権限

このプロシージャには、権限は必要ありません。

構文

ttRamPolicyGet()

結果セット

ttRamPolicyGetは次の結果を返します。

列

データ型

説明

ramPolicy

TT_VARCHAR (10)

データベースをシステムRAMにロードするタイミングを決定するために使用するポリシーです。有効な値は、次のとおりです。
always: データベースはシステムRAMに常時存在します。

manual: ユーザーがttAdmin -ramLoadコマンドを使用して明示的にロードする場合にのみ、データベースはシステムRAMにロードされます。

inUse: データベースが使用中(アプリケーションの接続時)にのみシステムRAMにロードされます。このオプションは、一時データベースでは使用できません。一時データベースは手動でのみRAMにロードできます。ポリシーを設定しようとすると、警告が表示されます。

ramGrace

TT_INTEGER

このフィールドは、ramPolicyがinUseの場合に、最後のアプリケーションが切断されてから何秒後までデータベースがRAMに保持されるかをレポートします。これ以外の場合、このフィールドはNULLです。

パラメータ

ttRamPolicyGetにパラメータはありません。

例

RAMポリシーを表示するには、次のように実行します。

CALL ttRamPolicyGet();

関連項目

ttRamPolicySet
「ttAdmin」
『Oracle TimesTen In-Memory Databaseオペレーション・ガイド』のRAMポリシーの指定に関する説明

ttRamPolicySet

説明

このプロシージャは、データベースがメモリーにロードされるタイミングを決定するために使用するポリシーを定義します。ポリシーは、always、manual、inUseのいずれかです。

必要な権限

このプロシージャには、ADMIN権限が必要です。

構文

ttRamPolicySet('ramPolicy', [ramGrace])

パラメータ

ttRamPolicySetには、次のパラメータがあります。

パラメータ

データ型

説明

ramPolicy

TT_VARCHAR (10) NOT NULL

データベースをシステムRAMにロードするタイミングを決定するために使用するポリシーです。有効な値は、次のとおりです。
always: データベースはシステムRAMに常時存在します。

manual: ユーザーがttAdmin -ramLoadコマンドを使用して明示的にロードする場合にのみ、データベースはシステムRAMにロードされます。

inUse: データベースが使用中(アプリケーションの接続時)にのみシステムRAMにロードされます。このオプションは、一時データベースでは使用できません。一時データベースは手動でのみRAMにロードできます。ポリシーを設定しようとすると、警告が表示されます。

ramGrace

TT_INTEGER

最後のアプリケーションが切断されてから何秒後までデータベースをRAMに保持するかを設定します。この値は、ramPoliyがinUseの場合にのみ有効です。このパラメータはオプションであり、省略するか、NULLを設定した場合、既存のramGrace期間は、変更されません。

結果セット

ttRamPolicySetは結果を返しません。

例

データベースをRAMにロードするポリシーをinUseに設定し、データベースが、最後のアプリケーションが切断された後も10秒間RAMに保持されるようにするには、次のように実行します。

CALL ttRamPolicySet('inUse', 10);

関連項目

ttRamPolicyGet
「ttAdmin」
『Oracle TimesTen In-Memory Databaseオペレーション・ガイド』のRAMポリシーの指定に関する説明

ttRedundantIndexCheck

説明

このプロシージャは、指定された表(または現在のユーザーのすべての表)をスキャンして、冗長索引を見つけます。冗長索引の名前および削除する索引に関するアドバイスを返します。

必要な権限

このプロシージャには、権限は必要ありません。

構文

ttRedundantIndexCheck('tblname')

パラメータ

ttRedundantIndexCheckには、次のパラメータがあります。

パラメータ

データ型

説明

tblName

TT_CHAR(61)

アプリケーション表の名前。表の所有者を含めることができます。NULLまたは空の文字列を値として指定すると、現在のユーザーのすべての表の冗長索引がスキャンされます。
表名の指定にシノニムは使用できません。

結果セット

ttRedundantIndexCheckは次の結果を返します。

列

データ型

説明

redundancy

TT_VARCHAR (1024) NOT NULL

冗長索引の名前および削除する索引に関するアドバイス。

例

主キーを持つ表yを作成します。次に、索引iを作成します。冗長索引が作成されているという警告が返されます。別の索引i1を作成します。コマンドは失敗し、エラーが返されます。このプロシージャをコールして、警告を表示します。

CREATE TABLE y (ID tt_integer primary key);
CREATE INDEX i ON y (id);

Warning 2240: New non-unique index I has the same key
columns as existing unique index Y; consider dropping index I

CREATE INDEX i1 ON y (id);

2231: New index I1 would be identical to existing index I
The command failed.

CALL ttredundantindexcheck ('y');

< Non-unique index SCOTT.Y.I has the same key columns
as unique index SCOTT.Y.Y;
consider dropping index SCOTT.Y.I >
1 row found.

ttRepDeactivate

説明

このプロシージャは、アクティブ・スタンバイ・ペアのアクティブ・データベースの状態をACTIVEからIDLEに変更します。アクティブ・スタンバイ・ペアのマスター・データベースのロールを元に戻す場合に、このプロシージャを使用します。

必要な権限

このプロシージャには、ADMIN権限が必要です。

構文

ttRepDeactivate()

パラメータ

ttRepDeactivateにパラメータはありません。

結果セット

ttRepDeactivateは結果を返しません。

例

アクティブ・スタンバイ・ペアのアクティブ・データベースを無効にするには、次のコマンドを使用します。

CALL ttRepDeactivate();

関連項目

ttRepTransmitGet
ttRepTransmitSet
ttReplicationStatus
ttRepPolicySet
ttRepStateSave
ttRepStateSet
ttRepStop
ttRepSubscriberStateSet
ttRepSubscriberWait
『Oracle TimesTen In-Memory Database C開発者ガイド』のttRepDuplicateExに関する説明

ttReplicationStatus

説明

このプロシージャは、1つ以上のレプリケーション・ピア・データベースの状態を返します。

必要な権限

このプロシージャには、権限は必要ありません。

構文

ttReplicationStatus(['subscriber'], ['hostname'])

パラメータ

ttReplicationStatusには、次のオプションのパラメータがあります。

パラメータ

データ型

説明

subscriber

TT_VARCHAR(200)

関係するサブスクライバ(すべてのサブスクライバの場合はNULL)。パラメータを指定すると、情報を収集するレプリケーション・サブスクライバが指定されます。パラメータを指定しないと、現在のデータベースに定義されているレプリケーション・サブスクライバに関する情報が返されます。

hostname

TT_VARCHAR(200)

実行中のデータ・ストアから更新を受信するように構成された、1つ以上のデータ・ストアのホスト名(NULLの場合、受信側のデータ・ストアはサブスクライバのみによって識別されます)。レシーバおよびホスト名の両方がNULLの場合、受信側のすべてのデータ・ストアが選択されます。

結果セット

ttReplicationStatusは次の結果セットを返します。

列

データ型

説明

subscriber

TT_VARCHAR (200) NOT NULL

サブスクライバ名。

hostName

TT_VARCHAR (200) NOT NULL

サブスクライバをホスティングするシステムの名前。

port

TT_INTEGERNOT NULL

マスターからの更新を受信するサブスクライバ・エージェントで使用されるTCP/IPポート。値が0(ゼロ)の場合は、レプリケーションでポートが自動的に割り当てられたことを示します。

pState

TT_CHAR (10) NOT NULL

マスター・データベースに対するサブスクライバの現在のレプリケーションの状態。結果列の値は次のとおりです。
start: このピアでは、レプリケーションは有効です。

pause: このピアでは、レプリケーションは一時停止中です。TimesTenは更新を保存します。詳細は、『Oracle TimesTen In-Memory Database開発者および管理者ガイド』のサブスクライバのレプリケーション状態の設定に関する説明を参照してください。

stop: このピアのためのレプリケーションの更新は収集されていません。

failed: しきい値(ログ・データ)を超えているため、サブスクライバへのレプリケーションは失敗したとみなされます。この状態は、システムによって設定されます。

logs

TT_INTEGERNOT NULL

マスター・データベースがサブスクライバのために保持しているトランザクション・ログ・ファイルの数。

lastMsg

TT_INTEGER

最後の対話以降の秒数またはNULL。

replicationName

TT_CHAR (30) NOT NULL

レプリケーション・スキームの名前。

replicationOwner

TT_CHAR (30) NOT NULL

レプリケーション・スキームの所有者。

例

Command> call ttReplicationStatus();
< MASTER2, HOST1, 0, start     , 1, 257142, \
_ACTIVESTANDBY         , TTREP       >
1 row found.

Command> call ttReplicationStatus('master2', 'host1');
< MASTER2, HOST1, 0, start     , 1, 266439, \
_ACTIVESTANDBY                , TTREP                          >
1 row found.

注意

receiverパラメータがNULLでない場合、指定されたレシーバの状態のみが返されます。receiverパラメータがNULLである場合、すべてのサブスクライバの状態が返されます。

このプロシージャはTimesTen Data Manager ODBCアプリケーションでのみサポートされています。TimesTen ClientまたはJDBCアプリケーションではサポートされていません。

関連項目

ttRepDeactivate
ttRepPolicySet
ttRepStop
ttRepSubscriberStateSet
ttRepSyncGet
ttRepSyncSet
ttRepTransmitSet
『Oracle TimesTen In-Memory Database C開発者ガイド』のttRepDuplicateExに関する説明

ttRepPolicyGet

説明

このプロシージャは、接続されたデータベースに対してTimesTenを実行するタイミングを決定するレプリケーションの再起動ポリシーを返します。ポリシーは、always、manual、norestartのいずれかです。

必要な権限

このプロシージャには、権限は必要ありません。

構文

ttRepPolicyGet()

パラメータ

ttRepPolicyGetにパラメータはありません。

結果セット

ttRepPolicyGetは次の結果を返します。

列

データ型

説明

repPolicy

TT_VARCHAR (10)

データベースに対してTimesTenレプリケーション・エージェントを実行するタイミングを決定するために使用するポリシー。有効な値は、次のとおりです。
always: レプリケーション・エージェントはデータベースに対して常時実行されます。このオプションは、TimesTenレプリケーション・エージェントをただちに起動します。TimesTenデーモンが再起動されると、自動的にレプリケーション・エージェントが再起動されます。

manual: ttRepStart組込みプロシージャまたはttAdmin -repStartコマンドのいずれかを使用して、レプリケーション・エージェントを手動で起動する必要があります。ttRepStop組込みプロシージャまたはttAdmin -repStopコマンドのいずれかを使用して、レプリケーション・エージェントを明示的に停止する必要があります。

norestart: エラーが発生した後、データベースに対するレプリケーション・エージェントは再起動されません。

例

TimesTenレプリケーション・エージェントのポリシーをalwaysに設定するには、次のように実行します。

CALL ttRepPolicyGet();

関連項目

ttRepDeactivate
ttRepTransmitSet
ttReplicationStatus
ttRepPolicySet
ttRepStart
ttRepStop
ttRepSubscriberStateSet
ttRepSubscriberWait
ttRepSyncGet
ttRepSyncSet
『Oracle TimesTen In-Memory Database C開発者ガイド』のttRepDuplicateExに関する説明

ttRepPolicySet

説明

このプロシージャは、接続されたデータベースに対してTimesTenを実行するタイミングを決定するレプリケーションの再起動ポリシーを定義します。ポリシーは、always、manual、norestartのいずれかです。

必要な権限

このプロシージャには、ADMIN権限が必要です。

構文

ttRepPolicySet('repPolicy')

パラメータ

ttRepPolicySetには、次のパラメータがあります。

パラメータ

データ型

説明

repPolicy

TT_VARCHAR (10) NOT NULL

データベースに対してTimesTenレプリケーション・エージェントを実行するタイミングを決定するために使用するポリシーを指定します。有効な値は、次のとおりです。
always: レプリケーション・エージェントはデータベースに対して常時実行されます。このオプションは、TimesTenレプリケーション・エージェントをただちに起動します。TimesTenデーモンが再起動されると、自動的にレプリケーション・エージェントが再起動されます。

manual: ttRepStart組込みプロシージャまたはttAdmin -repStartコマンドのいずれかを使用して、レプリケーション・エージェントを手動で起動する必要があります。ttRepStop組込みプロシージャまたはttAdmin -repStopコマンドのいずれかを使用して、レプリケーション・エージェントを明示的に停止する必要があります。

norestart: エラーが発生した後、データベースに対するレプリケーション・エージェントは再起動されません。

結果セット

ttRepPolicySetは結果を返しません。

例

TimesTenレプリケーション・エージェントのポリシーをalwaysに設定するには、次のように実行します。

CALL ttRepPolicySet('always');

関連項目

ttRepDeactivate
ttRepTransmitSet
ttReplicationStatus
ttRepPolicyGet
ttRepStart
ttRepStop
ttRepSubscriberStateSet
ttRepSubscriberWait
ttRepSyncGet
ttRepSyncSet
『Oracle TimesTen In-Memory Database C開発者ガイド』のttRepDuplicateExに関する説明

ttRepQueryThresholdGet

説明

このプロシージャは、レプリケーション・エージェントの問合せしきい値として最後に指定された秒数を返します。返された秒数は、有効な問合せしきい値と同じでない場合があります。問合せしきい値に新たに設定した値は、次回レプリケーション・エージェントが起動されたときに有効になります。

必要な権限

このプロシージャには、ADMIN権限が必要です。

構文

ttRepQueryThresholdGet()

パラメータ

ttRepQueryThresholdGetにパラメータはありません。

結果セット

ttRepQueryThresholdGetは次の結果を返します。

列

データ型

説明

repQueryThreshold

TT_INTEGER

レプリケーション問合せの最大実行秒数(この秒数を超えるとエラーが返されます)。

例

レプリケーションの問合せしきい値を取得するには、次のコマンドを実行します。

CALL ttRepQueryThresholdGet;
< 4 >
1 row found.

関連項目

ttRepDeactivate
ttReplicationStatus
ttRepPolicyGet
ttRepQueryThresholdSet
ttRepStart
ttRepStop
ttRepSubscriberStateSet
ttRepSubscriberWait
ttRepSyncGet
ttRepSyncSet
ttRepTransmitSet
『Oracle TimesTen In-Memory Database C開発者ガイド』のttRepDuplicateExに関する説明

ttRepQueryThresholdSet

説明

このプロシージャは、レプリケーション・エージェントが問合せを実行できる最大秒数を指定し、この秒数を超えると、警告がサポート・ログに書き込まれ、SNMPトラップがスローされます。指定された値は、レプリケーション・エージェントを次に起動したときに有効になります。レプリケーション・エージェントの問合せしきい値は、マテリアライズド・ビューのディテール表に対するSQL実行、ON DELETE CASCADE処理、およびSQL文を実行する一部の内部処理に適用されます。

必要な権限

このプロシージャには、ADMIN権限が必要です。

構文

ttRepQueryThresholdSet(seconds);

パラメータ

ttRepQueryThresholdSetには、次のパラメータがあります。

パラメータ

データ型

説明

seconds

TT_INTEGERNOT NULL

レプリケーション・エージェントがSQL文を実行できる最大秒数(この秒数を超えると、警告がサポート・ログに書き込まれ、SNMPトラップがスローされます)。0以上の値を指定する必要があります。デフォルトは0で、TimesTenが警告を書き込まないことを示します。

結果セット

ttRepQueryThresholdSetは結果を返しません。

例

レプリケーションの問合せしきい値を4秒に設定するには、次のコマンドを実行します。

CALL ttRepQueryThresholdSet(4);

関連項目

ttRepDeactivate
ttReplicationStatus
ttRepPolicyGet
ttRepQueryThresholdGet
ttRepStart
ttRepStop
ttRepSubscriberStateSet
ttRepSubscriberWait
ttRepSyncGet
ttRepSyncSet
ttRepTransmitSet
『Oracle TimesTen In-Memory Database C開発者ガイド』のttRepDuplicateExに関する説明

ttRepStart

説明

このプロシージャは、接続しているデータベースに対してTimesTenレプリケーション・エージェントを起動します。

必要な権限

このプロシージャには、CACHE_MANAGER権限が必要です。

構文

ttRepStart()

パラメータ

ttRepStartにパラメータはありません。

結果セット

ttRepStartは結果を返しません。

例

レプリケーション・エージェントを起動するには、次のように実行します。

CALL ttRepStart();

注意

いずれのレプリケーション・スキームにもデータベースが存在しない場合、レプリケーション・エージェントは起動しません。

このプロシージャを使用する場合、コールを実行するアプリケーションを含めたすべてのアプリケーションは、データベース・レベルのロック(LockLevel=1)を指定する接続を保持することができません。

関連項目

ttRepDeactivate
ttRepTransmitGet
ttRepTransmitSet
ttReplicationStatus
ttRepPolicySet
ttRepStop
ttRepSubscriberStateSet
ttRepSubscriberWait
ttRepSyncSet
ttRepSyncGet
『Oracle TimesTen In-Memory Database C開発者ガイド』のttRepDuplicateExに関する説明

ttRepStateGet

説明

このプロシージャは、アクティブ・スタンバイ・ペアのデータベースの現在のレプリケーションの状態を返します。

必要な権限

このプロシージャには、権限は必要ありません。

構文

ttRepStateGet()

パラメータ

ttRepStateGetにパラメータはありません。

結果セット

ttRepStateGetは次の結果を返します。

列

データ型

説明

state

TT_VARCHAR (20) NOT NULL

データベースの現在のレプリケーションの状態。次のいずれかです。
ACTIVE: データベースは、現在アクティブ・マスター・データベースです。アプリケーションによって、レプリケートされた表が更新される場合があります。

STANDBY: データベースは、スタンバイ・マスター・データベースです。アプリケーションによって、レプリケートされていない表のみが更新される場合があります。

FAILED: データベースは、障害が発生したマスター・データベースです。更新はレプリケートされていません。

IDLE: データベースは、アクティブ・スタンバイ・ペアのロールを割り当てられていません。このデータベースは、アプリケーションまたはレプリケーションでは更新できません。すべてのストアがIDLE状態で表示されます。

RECOVERING - データ・ストアは、障害の発生後、アクティブ・ストアとの同期更新を処理中です。

gridState

TT_VARCHAR (20) NOT NULL

データベースの現在のグリッドの状態。次のいずれかです。
NO GRID - ノードはアタッチされていません。

AVAILABLE: ノードはアタッチされていて、ノードのロールはレプリケーション・ストアの状態と一致しており、アクティブまたはスタンバイのいずれかです。所有者の変更が発生する可能性のある処理を実行できます。このような処理には、AGING、DELETE、INSERT、LOAD、SELECTおよびUNLOADが含まれます。

IN TRANSITION: ノードはアタッチされていて、スタンバイ状態からアクティブ状態に移行中です。これはアクティブ・スタンバイ状態のフェイルオーバー中に発生する可能性があります。レプリケーション・ストアはアクティブですが、所有者の変更が可能な処理では使用できません。所有者の変更が可能な処理は許可されません。

UNAVAILABLE: ノードはアタッチされていますが、エラーのために最後のフェイルオーバー中にアクティブ・グリッドの状態に変更することができませんでした。レプリケーション・ストアの状態はすでにアクティブですが、所有者の変更が可能な処理は許可されません。ユーザーはエラー状態を修正し、明示的にttGridAttachプロシージャを実行してノードをアクティブ状態にする必要があります。

例

アクティブ・スタンバイ・ペアのレプリケーションとグリッド状態を決定するには、次のコマンドを使用します。

Call ttRepStateGet();
<STANDBY, NO GRID>

Call ttRepStateGet();
<ACTIVE, NO GRID>

Call ttRepStateGet();
<ACTIVE, AVAILABLE>

Call ttRepStateGet();
<ACTIVE, UNAVAILABLE>

関連項目

ttRepDeactivate
ttRepTransmitSet
ttReplicationStatus
ttRepPolicySet
ttRepStateSave
ttRepStateSet
ttRepStop
ttRepSubscriberStateSet
ttRepSubscriberWait
『Oracle TimesTen In-Memory Database C開発者ガイド』のttRepDuplicateExに関する説明

ttRepStateSave

説明

アクティブ・スタンバイ・ペアのリモート・ピア・データベースの状態を現在接続されているデータベースに保存します。現在、スタンバイ・データベース(hostName上のstoreName)で障害が発生したこと、およびアクティブ・データベースに対するすべての更新を読取り専用サブスクライバに直接レプリケートする必要があることをアクティブ・データベースに通知するためにのみ使用されます。

必要な権限

このプロシージャには、ADMIN権限が必要です。

構文

ttRepStateSave('state', 'storeName', 'hostName')

パラメータ

ttRepStateSaveには、次のパラメータがあります。

パラメータ

データ型

説明

state

TT_VARCHAR (20) NOT NULL

データベースのレプリケーションの状態。このリリースでは、FAILEDとしてのみ指定できます。スタンバイ・データベースで障害が発生したことを記録すると、レプリケートされたすべての更新が、アクティブ・データベースから読取り専用サブスクライバに直接送信されるように指定されます。

storeName

TT_VARCHAR (200) NOT NULL

状態が示されるデータベース名。

hostName

TT_VARCHAR (200)

データベースが存在するホスト名。

結果セット

ttRepStateSaveは結果を返しません。

例

backup1というホスト上のスタンバイ・データベースstandbyで障害が発生したことをアクティブ・データベースに通知するには、次のように実行します。

ttRepStateSave('FAILED', 'standby', 'backup1');

関連項目

ttRepDeactivate
ttRepTransmitSet
ttReplicationStatus
ttRepPolicySet
ttRepStateGet
ttRepStateSet
ttRepStop
ttRepSubscriberStateSet
ttRepSubscriberWait
ttRepSyncGet
ttRepSyncSet
『Oracle TimesTen In-Memory Database C開発者ガイド』のttRepDuplicateExに関する説明

ttRepStateSet

説明

このプロシージャは、アクティブ・スタンバイ・ペアのデータベースのレプリケーション・スキームの状態を設定します。現在、ttRepStateSetは、データベースの状態をACTIVEにするためにのみ使用でき、ACTIVEは、データベースがアクティブ・スタンバイ・ペアでアクティブな役割を果たすことを示します。ttRepStateSetは、次の状況でのみ使用できます。

- データベースで、CREATE ACTIVE STANDBY PAIRコマンドが実行され、それ以降、障害が発生していない場合。

- データベースが現在STANDBY状態で、アクティブ・スタンバイ・ペアの他のデータベースでttRepDeactivateプロシージャが使用されてその状態がACTIVEからIDLEに変更された場合。

- データベースがローカル・トランザクション・ログからリカバリした直後で、停止前はACTIVE状態であった場合。

必要な権限

このプロシージャには、ADMIN権限が必要です。

構文

ttRepStateSet('state')

パラメータ

ttRepStateSetには、次のパラメータがあります。

パラメータ

データ型

説明

state

TT_VARCHAR (20) NOT NULL

データベースのレプリケーションの状態。このリリースでは、ACTIVEと設定する必要があります。ストアをACTIVEに設定すると、アクティブ・スタンバイ・ペアのアクティブ・データベースとして指定されます。

結果セット

ttRepStateSetは結果を返しません。

例

データベースのレプリケーションの状態をACTIVEに設定するには、次のように実行します。

CALL ttRepStateSet('ACTIVE');

関連項目

ttRepDeactivate
ttRepTransmitSet
ttReplicationStatus
ttRepPolicySet
ttRepStateGet
ttRepStateSave
ttRepStop
ttRepSubscriberStateSet
ttRepSubscriberWait
ttRepSyncGet
ttRepSyncSet
『Oracle TimesTen In-Memory Database C開発者ガイド』のttRepDuplicateExに関する説明

ttRepStop

説明

このプロシージャは、接続しているデータベースに対してTimesTenレプリケーション・エージェントを停止します。

必要な権限

このプロシージャには、CACHE_MANAGER権限が必要です。

構文

ttRepStop()

パラメータ

ttRepStopにパラメータはありません。

結果セット

ttRepStopは結果を返しません。

例

レプリケーション・エージェントを停止するには、次のように実行します。

CALL ttRepStop();

注意

このプロシージャを使用する場合、コールを実行するアプリケーションを含めたすべてのアプリケーションは、データベース・レベルのロック(LockLevel=1)を指定する接続を保持することができません。

関連項目

ttRepDeactivate
ttRepTransmitSet
ttReplicationStatus
ttRepPolicySet
ttRepStart
ttRepSubscriberStateSet
ttRepSubscriberWait
ttRepSyncGet
ttRepSyncSet
『Oracle TimesTen In-Memory Database C開発者ガイド』のttRepDuplicateExに関する説明

ttRepSubscriberStateSet

説明

このプロシージャは、実行中のマスター・ストアのレプリケーション・サブスクライバの状態を変更します。

必要な権限

このプロシージャには、ADMIN権限が必要です。

構文

ttRepSubscriberStateSet('replicationName', 'replicationOwner',
'subscriberStoreName', 'subscriberHostName', newStateCode)

パラメータ

ttRepSubscriberStateSetには、次のパラメータがあります。

パラメータ

データ型

説明

replicationName

TT_CHAR (30)

処理対象のレプリケーション・スキーム名です。NULLは、すべてのレプリケーション・スキームを示します。

replicationOwner

TT_CHAR (30)

レプリケーション・スキームの所有者です。NULLは、すべてのレプリケーション・スキーム所有者を示します。

subscriberStoreName

TT_VARCHAR (200)

状態を設定するサブスクライバのデータベース名です。NULLは、subscriberHostNameホスト上のすべてのストアを示します。

subscriberHostName

TT_VARCHAR (200)

サブスクライバのホストです。NULLは、サブスクライバのピアのすべてのホストを示します。

newStateCode

TT_INTEGER

指定されたサブスクライバの新しい状態を表す整数コードです。
0/NULL - 開始(デフォルト)。サブスクライバへのレプリケーションを開始します。

1 - 一時停止。更新を保持したまま、レプリケーション・エージェントを一時停止します。

2 - 停止。サブスクライバへのレプリケーションを停止し、更新を破棄します。

その他のすべての状態コードは許可されません。(このプロシージャでは、サブスクライバの状態を「failed」に設定することはできません。)詳細は、『Oracle TimesTen In-Memory Database開発者および管理者ガイド』のサブスクライバのレプリケーション状態の設定に関する説明を参照してください。

結果セット

ttRepSubscriberStateSetは結果を返しません。

例

次の例では、REPL.REPSCHEMEというレプリケーション・スキームについて、サブスクライバ・データベース(SUBSCRIBERDS ON SYSTEM1)の状態を停止(2)に設定するようにマスター・データベースに指示します。

CALL ttRepSubscriberStateSet('REPSCHEME', 'REPL',
'SUBSCRIBERDS','SYSTEM1', 2);

すべてのサブスクライバの状態を一時停止(1)に設定するようマスター・データベースに指示するには、次のように実行します。

CALL ttRepSubscriberStateSet( , , , , 1 );

パラメータを指定しない場合の動作は、NULLを使用した場合と同じです。

関連項目

ttRepDeactivate
ttRepTransmitSet
ttReplicationStatus
ttRepPolicySet
ttRepStart
ttRepStop
ttRepSubscriberWait
ttRepTransmitGet
ttRepTransmitSet
『Oracle TimesTen In-Memory Database C開発者ガイド』のttRepDuplicateExに関する説明

ttRepSubscriberWait

説明

このプロシージャでは、コール元は、コール前にコミットされたすべてのトランザクションがサブスクライバsubscriberStoreNameに送信されるまで待機します。さらに、サブスクライバ・データベースで更新が永続的にコミットされたことをこのサブスクライバが認識するまで待機します。

他に保留中のトランザクションがアクティブ・データベースにない場合は、別のトランザクションでこのプロシージャをコールします。アクティブ・データベース上で開かれているトランザクションがある場合、このコールはエラーを返します。

waitTimeパラメータを-1に、subscriberStoreNameパラメータをNULLに設定した場合、プロシージャのコール時点までにコミットされたすべての更新がすべてのサブスクライバに送信され、更新が永続的にコミットされたことをすべてのサブスクライバが認識するまで、ttRepSubscriberWaitプロシージャは結果を返しません。

緊急レスポンスが必要な場合は、ttRepSubscriberWaitプロシージャを使用しないでください。RETURN RECEIPTサービスを使用してください。

注意:
すべての書込みトランザクション・アクティビティがストアで静止された後にこのプロシージャがコールされた場合(アクティブなトランザクション、起動されているトランザクションがない状態)、すべての更新がサブスクライバで永続的にコミットされていることを示す応答をサブスクライバが送信するまでに60秒以上かかる可能性があります。

必要な権限

このプロシージャには、権限は必要ありません。

構文

ttRepSubscriberWait('replicationName', 'replicationOwner',
'subscriberStoreName', 'subscriberHostName', waitTime)

パラメータ

ttRepSubscriberWaitには、次のパラメータがあります。

パラメータ

データ型

説明

replicationName

TT_CHAR (30)

処理対象のレプリケーション・スキーム名です。NULLは、すべてのレプリケーション・スキームを示します。

replicationOwner

TT_CHAR (30)

レプリケーション・スキームの所有者です。NULLは、すべてのレプリケーション・スキーム所有者を示します。

subscriberStoreName

TT_VARCHAR (200)

状態を設定するサブスクライバのデータベース名です。NULLは、subscriberHostNameホスト上のすべてのストアを示します。

subscriberHostName

TT_VARCHAR(200)

サブスクライバのホストです。NULLは、サブスクライバのピアのすべてのホストを示します。

waitTime

TT_INTEGERNOT NULL

指定したサブスクライバを待機する時間(秒)。-1は永久に待機することを表します。このパラメータは必須で、NULLは使用できません。

結果セット

ttRepSubscriberWaitは次の結果セットを返します。

列

データ型

説明

timeOut

BINARY(1)

0x00: 指定されたwaitTime内で待機は成功し、指定されたサブスクライバは、このプロシージャがコールされた時点の最新状態になっています。十分な時間が割り当てられていない場合、TimesTenは0x01を返します。

例

定義済レプリケーション・スキームREPOWNER.REPSCHEMEが1つある場合に、SERVER2上のサブスクライバREP2が追いつくまで送信側データ・ストアを10分待機させるには、次のように実行します。

CALL ttRepSubscriberWait('REPSCHEME','REPOWNER',
'REP2', 'SERVER2', 600);

関連項目

ttRepDeactivate
ttRepTransmitSet
ttReplicationStatus
ttRepPolicySet
ttRepStart
ttRepStop
ttRepSubscriberStateSet
ttRepSyncGet
ttRepSyncSet
『Oracle TimesTen In-Memory Database C開発者ガイド』のttRepDuplicateExに関する説明

ttRepSyncGet

説明

このプロシージャは、コール元でのレプリケーション・ベースのRETURNサービスの使用状況に関連付けられた静的属性を返します。このプロシージャは、RETURN RECEIPTサービスまたはRETURN TWOSAFEサービスのいずれかとともに動作します。

必要な権限

このプロシージャには、権限は必要ありません。

構文

ttRepSyncGet()

パラメータ

ttRepSyncGetにパラメータはありません。

結果セット

ttRepSyncGetは次の結果セットを返します。

列

データ型

説明

requestReturn

BINARY(1)descr

0(デフォルト): RETURN RECEIPT BY REQUESTまたはRETURN TWOSAFE BY REQUESTオプションによって設定されるリターン通知を待機しません。
1: リターン通知を待機します。コミットすると、この属性はデフォルト値の0 (オフ)にリセットされます。

returnWait

TT_INTEGER

RETURNサービスの応答を待機する秒数を指定します。デフォルト値は10秒です。0は待機時間がないことを意味します。この属性はトランザクションをまたいで動作し、BY REQUESTオプションとは独立して、すべてのRETURNサービスに適用されます。

localAction

TT_INTEGER

RETURNサービスの現在のLOCAL ACTION構成です。
1 (デフォルト) - NO ACTION。COMMITがタイムアウトすると、ブロックされていないアプリケーションが返され、トランザクションはCOMMIT開始時と同じ状態のままになります。アプリケーションはCOMMITのみを再発行する場合があります。

2 - COMMIT。COMMITがタイムアウトすると、トランザクションはローカルでコミットされます。この属性は、接続されているかぎり、トランザクションをまたいで存続します。

例

コール元のrequestReturn値を取得するには、次のように実行します。

SQLCHAR requestReturn[1];
SQLINTEGER    len;
rc = SQLExecDirect   ( hstmt
, (SQLCHAR *) "{CALL ttRepSyncGet( NULL )}"
, SQL_NTS )
rc = SQLBindCol     ( hstmt
, /* ColumnNumber */      1
, /* TargetType */      SQL_C_BINARY )
, /* TargetValuePtr */     requestReturn
,./* BufferLength */      sizeof requestReturn
, /* StrLen_ */         &len );
rc = SQLFetch( hstmt );
if ( requestReturn[0] ) {
...
}

注意

スタンドアロンのトランザクション内でコールすると、ttRepSyncGetは常に、requestReturnのデフォルト値を返します。

アプリケーションはトランザクション内のどの時点でもttRepSyncGetをコールすることができ、そのトランザクションに対するBY REQUESTを指定したRETURNサービスをリクエストするために使用できます。

RETURN RECEIPT BY REQUESTまたはRETURN TWOSAFE BY REQUESTレプリケーション要素の更新を行わないトランザクションでttRepSyncGetをコールしても、外部的な影響はありません。

関連項目

ttRepDeactivate
ttRepTransmitSet
ttReplicationStatus
ttRepPolicySet
ttRepStart
ttRepStop
ttRepSubscriberStateSet
ttRepSubscriberWait
ttRepSyncSet
『Oracle TimesTen In-Memory Database C開発者ガイド』のttRepDuplicateExに関する説明

ttRepSyncSet

説明

このプロシージャは、コール元でのレプリケーション・ベースのRETURNサービスの使用状況に関連付けられた静的属性を設定します。このプロシージャは、RETURN RECEIPTサービスまたはRETURN TWOSAFEサービスのいずれかとともに動作します。

必要な権限

このプロシージャには、権限は必要ありません。

構文

ttRepSyncSet([requestReturn], [returnWait], [localAction])

パラメータ

ttRepSyncSetには、次のオプションのパラメータがあります。

パラメータ

データ型

説明

requestReturn

BINARY(1)

0x00: 現在のトランザクションのRETURNサービスを無効にします。
0x01: 現在のトランザクションのRETURNサービスを有効にします。トランザクションをコミットすると、この属性はデフォルト値の0(オフ)にリセットされます。

レプリケーション・サブスクライバがRETURN RECEIPT BY REQUESTまたはRETURN TWOSAFE BY REQUESTで構成されている場合にのみ、このパラメータを使用してRETURNサービスを有効または無効にできます。

returnWait

TT_INTEGER

RETURNサービスの応答を待機する秒数を指定します。デフォルト値は10です。0は待機時間がないことを意味します。
このタイムアウト値は、CREATE REPLICATION文またはALTER REPLICATION文のRETURN WAIT TIME属性で設定された値より優先されます。

このパラメータによって設定されたタイムアウトはトランザクションをまたいで動作し、BY REQUESTオプションとは独立して、すべてのRETURNサービスに適用されます。

localAction

TT_INTEGER

returnWaitによって指定されたタイムアウト時間内に、サブスクライバがトランザクションのコミットを認識できない場合に実行されるアクションです。このパラメータは、RETURN TWOSAFEトランザクションに対してのみ使用できます。RETURNサービスの使用時はNULLに設定します。
1 (デフォルト) - NO ACTION。COMMITがタイムアウトすると、ブロックされていないアプリケーションが返され、トランザクションはCOMMIT開始時と同じ状態のままになります。アプリケーションはCOMMITのみを再発行する場合があります。

2 - COMMIT。COMMITがタイムアウトすると、トランザクションはローカルでコミットされます。この属性は、接続されているかぎり、トランザクションをまたいで存続します。

結果セット

ttRepSyncSetは結果を返しません。

例

RETURN RECEIPT BY REQUESTまたはRETURN TWOSAFE BY REQUESTで構成されたすべてのレプリケーション要素に対する現在のトランザクションでRETURN RECEIPTサービスを有効にするには、次のように実行します。

rc = SQLExecDirect ( hstmt,
(SQLCHAR *)"{CALL ttRepSyncSet( 0x01 )}",
SQL_NTS )

注意

RETURN RECEIPTサービスを有効にするコールは、トランザクションの一部である必要があります(AutoCommitは無効である必要があります)。

関連項目

ttRepDeactivate
ttRepTransmitSet
ttReplicationStatus
ttRepPolicySet
ttRepStart
ttRepStop
ttRepSubscriberStateSet
ttRepSubscriberWait
ttRepSyncGet
『Oracle TimesTen In-Memory Database C開発者ガイド』のttRepDuplicateExに関する説明

ttRepSyncSubscriberStatus

説明

このプロシージャは、RETURNサービス、およびサブスクライバに対するRETURNサービス・ブロッキングが障害ポリシーによって無効になっているかどうかを判断するRETURN DISABLE障害ポリシーで構成されているレプリケーション・スキームのサブスクライバ・データベースへの問合せを行います。

ttRepSyncSubscriberStatusプロシージャは、指定のホスト上にあり、指定した名前を持つサブスクライバ・データベースの障害状態を返します。storeNameのみを指定できます。ただし、レプリケーション・スキームで、異なるホスト上に同じ名前を持つサブスクライバが複数含まれる場合は、エラーが生成されます。

必要な権限

このプロシージャには、権限は必要ありません。

構文

ttRepSyncSubscriberStatus('subscriber', 'hostName')

パラメータ

ttRepSyncSubscriberStatusには、次のパラメータがあります。

パラメータ

データ型

説明

subscriber

TT_VARCHAR (200) NOT NULL

問合せを行うサブスクライバ・データベースの名前。

hostName

TT_VARCHAR (200)

実行中のデータ・ストアから更新を受信するように構成された、1つ以上のデータ・ストアのホスト名(NULLの場合、受信側のデータ・ストアはレシーバのみによって識別されます)。レシーバおよびホスト名の両方がNULLの場合、受信側のすべてのデータ・ストアが選択されます。

結果セット

ttRepSyncSubscriberStatusは次の結果を返します。

列

データ型

説明

disabled

TT_INTEGER

値は次のいずれかです。
1: RETURNサービスがサブスクライバ・データベースで無効である場合。

0: RETURNサービスがサブスクライバ・データベースで有効なままである場合。

注意

レプリケーション・スキームでDISABLE RETURN ALLが指定される場合は、ttRepSyncSubscriberStatusを使用して、レプリケーション・スキーム内の各サブスクライバの状態を問い合せる必要があります。

ttRepTransmitGet

説明

このプロシージャは、現在のトランザクションについて、サブスクライバへの更新データの転送状態を返します。対応するttRepSyncSet組込みプロシージャを使用すると、サブスクライバへの更新の転送をトランザクションが終わるまで停止できます。

必要な権限

このプロシージャには、ADMIN権限が必要です。

構文

ttRepTransmitGet()

パラメータ

ttRepTransmitGetにパラメータはありません。

結果セット

ttRepTransmitGetは次の結果を返します。

列

データ型

説明

transmit

TT_INTEGER

0: 更新は、この接続のトランザクションが終了するまで、サブスクライバに転送されません。
1 (デフォルト): 更新は、この接続のサブスクライバに転送されています。

例

アクティブ・スタンバイ・ペアのアクティブ・データベースの転送状態を返すには、次のコマンドを使用します。

CALL ttRepTransmitGet();

関連項目

ttRepDeactivate
ttReplicationStatus
ttRepPolicySet
ttRepStateSave
ttRepStateSet
ttRepStop
ttRepSubscriberStateSet
ttRepSubscriberWait
ttRepTransmitSet
『Oracle TimesTen In-Memory Database C開発者ガイド』のttRepDuplicateExに関する説明

ttRepTransmitSet

説明

このプロシージャは、実行されている接続に対する後続の更新データを、サブスクライバにレプリケートしないようにします。トランザクションを部分的にレプリケートした場合には、トランザクションの不整合がリモート・ストアで発生しやすくなるため、このプロシージャは、注意して使用してください。更新データのレプリケーションが許可されない場合、サブスクライバのストアはマスター・ストアから分岐します。

必要な権限

このプロシージャには、ADMIN権限が必要です。

構文

ttRepTransmitSet(transmit)

パラメータ

ttRepTransmitSetには、次のパラメータがあります。

パラメータ

データ型

説明

transmit

TT_INTEGERNOT NULL

1に設定すると、この組込みプロシージャを実行した後で、更新が接続されているサブスクライバに転送されます。(これがデフォルトです。)
0 (ゼロ)に設定すると、このコールを発行した接続でコールが発行されたトランザクションが終了するまで、更新はどのサブスクライバにも転送されません。

結果セット

ttRepTransmitSetは結果を返しません。

例

アクティブ・スタンバイ・ペアのアクティブ・データベースを有効にするには、次のコマンドを使用します。

CALL ttRepTransmitSet(1);

アクティブ・スタンバイ・ペアのアクティブ・データベースを無効にするには、次のコマンドを使用します。

CALL ttRepTransmitSet(0);

関連項目

ttRepDeactivate
ttReplicationStatus
ttRepPolicySet
ttRepStateSave
ttRepStateSet
ttRepStop
ttRepSubscriberStateSet
ttRepSubscriberWait
ttRepTransmitGet
『Oracle TimesTen In-Memory Database C開発者ガイド』のttRepDuplicateExに関する説明

ttRepXactStatus

説明

このプロシージャは、RETURN RECEIPTまたはRETURN TWOSAFEレプリケーション・トランザクションの状態を確認します。組込みプロシージャttRepXactTokenGetを使用すると、RETURN RECEIPTまたはRETURN TWOSAFEトランザクションのトークンを受信できます。このトークンは、その後、入力パラメータとして、この組込みプロシージャへ渡されます。ここで使用されるのは、ttRepXactTokenGetから受信したトークンのみです。このプロシージャは、3つのパラメータ、サブスクライバ名、サブスクライバに関連するレプリケーション状態、およびRETURN TWOSAFEレプリケーション・トランザクションがコミット処理を開始し、完了していない場合にのみ返されるエラー文字列が含まれる行のリストを返します。

注意:
errorパラメータはRETURN TWOSAFEトランザクションでのみ返されます。

必要な権限

このプロシージャには、権限は必要ありません。

構文

ttRepXactStatus(xactID)

パラメータ

ttRepXactStatusには、次のパラメータがあります。

パラメータ

データ型

説明

xactID

VARBINARY (10000)

パラメータが指定されていない場合、次のいずれかのステータスが返されます。

- コミット処理を開始し、完了していないトランザクションでコールされた場合は、そのトランザクションのステータスが返されます。

- それ以外のときにコールされた場合は、RETURN RECEIPTモードまたはRETURN TWOSAFEモードであった接続で最後にコミットされたトランザクションのステータスが返されます。

結果セット

ttRepXactStatusは、次の結果セットを返します。

列

データ型

説明

subscriberName

TT_CHAR (61)

トランザクションで更新された表をサブスクライブするデータベース名。名前はstore_name@host_nameという形式で返されます。

state

TT_CHAR (2)

サブスクライバ・データベースに関連するトランザクションの状態。戻り値は、次のいずれかです。
'NS': サブスクライバに送信されていないトランザクション。

'RC': サブスクライバ・エージェントによって受信されたトランザクション。

'CT': サブスクライバ・ストアで適用されたトランザクション。(適用時にトランザクションでエラーが発生したかどうかは送信されません。)

'AP': トランザクションは永続的にサブスクライバに適用されています。

errorString

TT_VARCHAR (2000)

TWOSAFEトランザクションの適用時に発生したエラーを説明するサブスクライバ・エージェントによって返されたエラー文字列。エラーが発生していない場合、このパラメータはNULLです。コミット処理を開始し、まだ完了していないTWOSAFEレプリケーション・トランザクション内でこのプロシージャがコールされた場合のみ、NULL以外の値が返されます。

関連項目

ttRepDeactivate
ttRepTransmitSet
ttReplicationStatus
ttRepPolicySet
ttRepStart
ttRepStop
ttRepSubscriberStateSet
ttRepSubscriberWait
ttRepSyncGet
ttRepSyncSet
ttRepXactTokenGet
『Oracle TimesTen In-Memory Database C開発者ガイド』のttRepDuplicateExに関する説明

ttRepXactTokenGet

説明

このプロシージャは、RETURN RECEIPTまたはRETURN TWOSAFEレプリケーション・トランザクションにトークンを返します。入力パラメータtypeによって、次のいずれかが返されます。

- トランザクションが呼び出された接続ハンドルで最後にコミットされたRETURN RECEIPTトランザクションへのトークン。

- トランザクションが呼び出された接続ハンドルにおける最新のトランザクションへのトークン。RETURN TWOSAFEモードのトランザクションでコミット処理が開始されている。

このプロシージャは、RETURN TWOSAFEレプリケーションのトランザクションに対してコミット処理が開始された後に、後続のトランザクションまたは同じトランザクションで実行できます。

必要な権限

このプロシージャには、権限は必要ありません。

構文

ttRepXactTokenGet('type')

パラメータ

ttRepXactTokenGetには、次のパラメータがあります。

パラメータ

データ型

説明

type

TT_CHAR (2) NOT NULL

希望するトランザクションのタイプ。
'RR' - RETURN RECEIPT。

'R2' - RETURN TWOSAFE。

結果セット

ttRepXactTokenGetは、次の結果セットを返します。

列

データ型

説明

token

VARBINARY (10000)

希望するトランザクションを表すVARBINARYトークン。

関連項目

ttRepDeactivate
ttRepTransmitSet
ttReplicationStatus
ttRepPolicySet
ttRepStart
ttRepStop
ttRepSubscriberStateSet
ttRepSubscriberWait
ttRepSyncGet
ttRepSyncSet
ttRepXactStatus
『Oracle TimesTen In-Memory Database C開発者ガイド』のttRepDuplicateExに関する説明

ttSetUserColumnID

説明

このプロシージャは、ユーザー指定の列IDを明示的に設定します。トランザクション・ログAPIによってアプリケーションに渡された更新には、表の列に関する情報が含まれることがあります。この列情報には、システム指定の列番号とユーザー指定の列識別子が含まれます。ユーザー指定の列IDは、このコールによって明示的に設定されるまで、値は0です。

システムは、CREATE TABLE処理またはALTER TABLE処理で各列にIDを割り当てます。ユーザーによって割り当てられた値を列IDに設定すると、データベース全体にわたり一意の列番号セットを設定したり、指定された表に対して固有の列番号方式を設定することができます。

必要な権限

このプロシージャには、XLA権限が必要です。

構文

ttSetUserColumnID('tblName', 'colName', repID)

パラメータ

ttSetUserColumnIDには、次のパラメータがあります。

パラメータ

データ型

説明

tblName

TT_CHAR (61) NOT NULL

表名。
表名の指定にシノニムは使用できません。

colName

TT_CHAR (30) NOT NULL

列名。

repID

TT_INTEGERNOT NULL

整数値の識別子。

結果セット

ttSetUserColumnIDは結果を返しません。

例

CALL ttSetUserColumnID('APP.SESSION', 'SESSIONID', 15);

関連項目

ttSetUserTableID
『Oracle TimesTen In-Memory Database開発者および管理者ガイド』

ttSetUserTableID

説明

このプロシージャは、ユーザー表IDの値を明示的に設定します。各行が関連付けられている表は、アプリケーションが提供するユーザー表IDのコードと、システムが提供するシステム表IDのコードの、2つのコードによって表現されます。更新は、完全な行の形でトランザクション・ログAPIによってアプリケーションに渡されます。ユーザー表IDは、プロシージャttSetUserTableIDによって明示的に設定されるまで、値は0です。

必要な権限

このプロシージャには、XLA権限が必要です。

構文

ttSetUserTableID('tblName', repID)

パラメータ

ttSetUserTableIDには、次のパラメータがあります。

パラメータ

データ型

説明

tblName

TT_CHAR(61) NOT NULL

表名。
表名の指定にシノニムは使用できません。

repID

BINARY(8) NOT NULL

整数値の識別子。

結果セット

ttSetUserTableIDは結果を返しません。

例

CALL ttSetUserTableID('APP.SESSION', 0x123456);

関連項目

ttSetUserColumnID
『Oracle TimesTen In-Memory Database開発者および管理者ガイド』

ttSize

説明

このプロシージャは、表またはビューのサイズおよび索引のサイズを推定します。表の推定バイト数が単一のDOUBLE列を持つ単一行として返されます。表は、表名または完全修飾された表名のいずれかとして指定できます。nrowsパラメータがNULL以外の場合、現在の表の統計が指定した行数まで拡大したものと想定して表のサイズが推定されます。nrowsパラメータがNULLの場合、表のサイズは現在の行数を使用して推定されます。

現在の表のコンテンツをスキャンして、VARBINARYおよびVARCHAR列の平均サイズが判断されます。表が空の場合、VARBINARY列とVARCHAR列の平均サイズは、宣言されている最大サイズの半分になるように推定されます。ttSizeによって計算される推定値には、表、VARBINARY列とVARCHAR列、およびその表に定義された索引の記憶域が含まれます。

この組込みプロシージャをコールすると表がスキャンされます。NULL以外のfrac(0と1の間)を指定することによって、表のスキャンを回避できます。この値は、可変長列の平均サイズを推定します。fracを各可変長列の最大サイズに掛けて、VARBINARY列またはVARCHAR列の推定平均サイズを計算します。fracパラメータを指定しないと、表内の既存の行がスキャンされ、既存の行における可変長列の平均長が使用されます。fracを省略した場合、表に行が存在しないと、fracの値は0.5であると想定されます。

必要な権限

このプロシージャでは、指定した表に対するSELECT権限が必要です。

構文

ttSize('tblName', [nRows], frac)

パラメータ

ttSizeには、次のパラメータがあります。

パラメータ

データ型

説明

tblName

TT_CHAR (61) NOT NULL

アプリケーション表の名前。表の所有者を含めることができます。このパラメータは必須です。
表名の指定にシノニムは使用できません。

nRows

TT_INTEGER

推定される表内の行数。このパラメータはオプションです。

frac

BINARY_DOUBLE

VARBINARY列またはVARCHAR列のサイズの推定される平均端数。このパラメータはオプションです。

結果セット

ttSizeは、次の結果セットを返します。

列

データ型

説明

size

BINARY_DOUBLE NOT NULL

推定される表のサイズ(バイト)。

例

CALL ttSize('ACCTS', 1000000, NULL);

CALL ttSize('ACCTS', 30000, 0.8);

CALL ttSize('SALES.FORECAST', NULL, NULL);

ttSizeを使用する場合、コマンドを実行した後、結果をフェッチする必要があります。次に例を示します。

ODBC

double size;
SQLLEN len;

rc = SQLExecDirect(hstmt, "call ttSize('SalesData', 250000,
0.75)", SQL_NTS);
rc = SQLBindColumn(hstmt, 1, SQL_C_DOUBLE, &size, sizeof double,
&len);
rc = SQLFetch(hstmt);
rc = SQLFreeStmt(hstmt, SQL_CLOSE);

JDBC

. . . . . .
String URL="jdbc:timesten:MyDataStore";
Connection con;
double tblSize=0;
. . . . . .
con = DriverManager.getConnection(URL);
CallableStatement cStmt = con.prepareCall("
{CALL ttSize('SalesData', 250000, 0.75) }");
if( cStmt.execute() )
{
rs=cStmt.getResultSet();
if (rs.next()) {
tblSize=rs.getDouble(1);
}
rs.close();
}
cStmt.close();
con.close();

. . . . . .

注意

ttSizeプロシージャを使用すると、行が完全にロードされたときに表がどの程度大きくなるかを、少量のサンプルをもとに推定できます。最適な結果を得るには、1,000以上の典型的な行を表にロードします。

関連項目

ttComputeTabSizes

ttSQLCmdCacheInfo

説明

このプロシージャは、TimesTen SQLコマンド・キャッシュのすべての準備されたSQL文に関する情報を返します。

必要な権限

このプロシージャには、ADMIN権限が必要です。

構文

ttSQLCmdCacheInfo([sqlCmdID])

パラメータ

ttSQLCmdCacheInfoには、次のオプションのパラメータがあります。

パラメータ

データ型

説明

sqlCmdID

32-bitシステムの場合はTT_INTEGER
64-bitシステムの場合はTT_BIGINT

TimesTenコマンド・キャッシュでのSQLコマンドの一意の識別子。値が指定しない場合、すべてのコマンドに関する情報が表示されます。

結果セット

ttSQLCmdCacheInfoは次の結果セットを返します。

列

データ型

説明

sqlCmdID

32-bitシステムの場合はTT_INTEGER NOT NULL
64-bitシステムの場合はTT_BIGINT NOT NULL

コマンドの一意の識別子。

privateCommandConnectionID

TT_INTEGER

コマンドがプライベートの場合、これは準備された場所の接続の接続IDです。プライベート・コマンドでない場合、この値は2048です。

executions

TT_BIGINT
NOT NULL

コマンドの実行回数をカウントします。

prepares

TT_BIGINTNOT NULL

コマンドの準備の数をカウントします。

reprepares

TT_BIGINT NOT NULL

コマンドの再準備の数をカウントします。

freeable

TT_TINYINT NOT NULL

このコマンドがサブデーモンによってガベージ収集可能かどうかを示します。
1 - 解放可能であることを示します。

0 - 解放可能でないことを示します。

size

TT_INTEGERNOT NULL

コマンド・キャッシュでこのコマンドに割り当てられた領域の合計(バイト)。

owner

TT_CHAR (31) NOT NULL

コマンドを作成したユーザー。

queryText

TT_VARCHAR (409600) NOT NULL

現在のコマンドの完全なSQLテキスト。

例

現在有効なすべてのコマンドに関する情報をttIsqlに表示するには、次のように実行します。

Command> call ttsqlcmdcacheinfo;
< 51635464, 2048, 12, 12, 0, 1, 3056, SYS                            , delete fr
om sys.idl_sb4$ where obj#=:1 and part=:2 >
< 43437072, 2048, 5, 5, 0, 1, 1960, SYS                            , select obj#
from sys.objerror$ >
< 51620736, 2048, 4, 4, 0, 1, 2736, SYS                            , delete from
sys.obj$ where obj# = :1 >
< 51680216, 2048, 1, 1, 0, 1, 3592, BWAF4EVR                       , call ttsqlc
mdcacheinfo(51623232) >
< 51676856, 2048, 2, 2, 0, 0, 3552, BWAF4EVR                       , call ttsqlc
mdcacheinfo >
< 43438936, 2048, 5, 5, 0, 1, 3200, SYS                            , select obj#
from sys.syn$ where owner=:1 and name=:2 >
< 44066504, 2048, 0, 14, 0, 1, 5640, SYS                            , select nul
l from sys.obj$ where obj#=:1 and type#=:2 and obj# not in (select p_obj# from d
ependency$ where p_obj# = sys.obj$.obj#) >
< 51649488, 2048, 1, 1, 0, 1, 2344, BWAF4EVR                       , create tabl
e tab1 (c1 number primary key not null, c2 number) >
< 51671608, 2048, 1, 1, 0, 1, 4656, BWAF4EVR                       , call ttSQLC
mdCacheInfo2(51635464) >
< 51666232, 2048, 1, 1, 0, 1, 2048, BWAF4EVR                       , call ttSQLC
mdCacheInfoGet >
< 51612064, 2048, 4, 4, 0, 1, 8424, SYS                            , select o.ow
ner#, o.name, o.namespace,    o.obj#, d.d_timestamp, nvl(d.property,0), o.type#,
d.d_attrs  from sys.dependency$ d, sys.obj$ o  where d.p_obj#=:1  and   (d.p_ti
mestamp=nvl(:2,d.p_timestamp) or d.property=2)  and   o.owner#=nvl(:3,o.owner#)
and   d.d_obj#=o.obj#  order by o.obj# >
< 43415648, 2048, 4, 4, 0, 1, 4544, BWAF4EVR                       , create acti
ve standby pair sampledb_1122, bwaf4evr_dummy1 subscriber bwaf4evr_dummy2 >
< 43431912, 2048, 5, 5, 0, 1, 4720, SYS                            , select owne
r#,name,namespace,obj#,type#,ctime,mtime,stime,status,flags from sys.obj$ where
obj#=:1 >
< 51657712, 2048, 4, 4, 0, 1, 3552, BWAF4EVR                       , call ttSQLC
mdCacheInfo >
< 51653200, 2048, 1, 1, 0, 1, 1816, BWAF4EVR                       , call ttxlab
ookmarkcreate('mybookmark', 0x01) >
< 43420768, 2048, 1, 1, 0, 1, 2064, BWAF4EVR                       , create tabl
e tab1 (c1 number, c2 number) >
< 44058168, 2048, 14, 14, 0, 1, 7760, SYS                            , select o.
owner#,o.obj#,u.name,o.name,o.namespace from sys.user$ u, sys.obj$ o where u.use
r#=o.owner#   and o.type#=:1   and not exists   (select p_obj# from sys.dependen
cy$ where p_obj# = o.obj#) order by o.obj# for update >
< 49370616, 2048, 1, 1, 0, 0, 4024, SYS                            , select u.us
er#, u.password, u.identification, u.astatus from sys.user$ u where u.name = :na
me and u.type# = 1 >
< 51655376, 2048, 2, 2, 0, 1, 2528, BWAF4EVR                       , select * fr
om tab1 >
< 51638280, 2048, 4, 4, 0, 1, 2544, SYS                            , delete from
sys.objauth$ where obj#=:1 >
< 43423200, 2048, 14, 14, 0, 1, 5520, SYS                            , select ow
ner#,name,namespace,obj#,type#,ctime,mtime,stime,status,flags from sys.obj$ wher
e owner#=:1 and name=:2 and namespace=:3 >
< 51668216, 2048, 1, 1, 0, 1, 3592, BWAF4EVR                       , call ttSQLC
mdCacheInfo(51635464) >
< 51661208, 2048, 3, 3, 0, 1, 4640, BWAF4EVR                       , call ttSQLC
mdCacheInfo2 >
< 43428992, 2048, 5, 5, 0, 1, 2800, SYS                            , select sys.
objectSequence.nextval from dual >
< 51629120, 2048, 12, 12, 0, 1, 3040, SYS                            , delete fr
om sys.idl_char$ where obj#=:1 and part=:2 >
< 51641192, 2048, 2, 2, 0, 1, 2112, BWAF4EVR                       , create tabl
e tab1 (c1 number not null, c2 number) >
< 43442488, 2048, 5, 5, 0, 1, 4616, SYS                            , insert into
sys.obj$(owner#,name,namespace,obj#,type#,ctime,mtime,stime,status,flags) value
s(:1,:2,:3,:4,:5,:6,:7,:8,:9,:10) >
< 51632072, 2048, 12, 12, 0, 1, 3040, SYS                            , delete fr
om sys.idl_ub2$ where obj#=:1 and part=:2 >
< 49375216, 2048, 0, 1, 0, 0, 4232, SYS                            , select 1 fr
om sys.sysauth$ s where (s.grantee# = :userid or s.grantee# = 1) and (s.privileg
e# = :priv or s.privilege# = 67) >
< 51626304, 2048, 12, 12, 0, 1, 3040, SYS                            , delete fr
om sys.idl_ub1$ where obj#=:1 and part=:2 >
< 51645776, 2048, 1, 1, 0, 1, 2344, BWAF4EVR                       , create tabl
e tab1 (c1 number primary key not null, col2 number) >
< 51623232, 2048, 4, 4, 0, 1, 2704, SYS                            , delete from
sys.source$ where obj#=:1 >
32 rows found.

sqlCmdID 527973892のコマンド情報をttIsqlに表示するには、次のように実行します。

Command> call ttSQLCmdCacheInfo(527973892);
< 527973892, 2048, 0, 1, 0, 1, 2872, TTUSER,
select * from t1 where x1 in (select x2 from t2) or
x1 in (select x3 from t3) order by 1, 2, 3 >
1 row found.

ttIsqlで情報を垂直形式で表示するには、次のように実行します。

Command> vertical call ttSQLCmdCacheInfo;
...

sqlCmdID 51623232の情報をttIsqlで垂直形式で表示するには、次のように実行します。

Command> vertical call ttsqlcmdcacheinfo(51623232);

SQLCMDID:                        51623232
PRIVATE_COMMAND_CONNECTION_ID:   2048
EXECUTIONS:                      4
PREPARES:                        4
REPREPARES:                      0
FREEABLE:                        1
SIZE:                            2704
OWNER:                           SYS
QUERYTEXT:                       delete from sys.source$ where obj#=:1

1 row found.

関連項目

ttSQLCmdCacheInfo2
ttSQLCmdCacheInfoGet

ttSQLCmdCacheInfo2

説明

このプロシージャは、TimesTen SQLコマンド・キャッシュのすべての準備されたSQL文に関する情報を返します。

これはttSQLCmdCacheInfoと似ていますが、結果セットの説明に示すとおり、追加の列が返されます。

必要な権限

このプロシージャには、ADMIN権限が必要です。

構文

ttSQLCmdCacheInfo2([sqlCmdID])

パラメータ

ttSQLCmdCacheInfo2には、次のオプションのパラメータがあります。

パラメータ

データ型

説明

sqlCmdID

32-bitシステムの場合はTT_INTEGER
64-bitシステムの場合はTT_BIGINT

TimesTenコマンド・キャッシュでのSQLコマンドの一意の識別子。値が指定しない場合、すべてのコマンドに関する情報が表示されます。

結果セット

ttSQLCmdCacheInfo2は次の結果セットを返します。

列

データ型

説明

sqlCmdID

32-bitシステムの場合はTT_INTEGER NOT NULL
64-bitシステムの場合はTT_BIGINT NOT NULL

コマンドの一意の識別子。

privateCommandConnectionID

TT_INTEGER

コマンドがプライベートの場合、これは準備された場所の接続の接続IDです。プライベート・コマンドでない場合、この値は2048です。

executions

TT_BIGINT
NOT NULL

コマンドの実行回数をカウントします。

prepares

TT_BIGINTNOT NULL

コマンドの準備の数をカウントします。

reprepares

TT_BIGINT NOT NULL

コマンドの再準備の数をカウントします。

freeable

TT_TINYINT NOT NULL

このコマンドがサブデーモンによってガベージ収集可能かどうかを示します。
1 - 解放可能であることを示します。

0 - 解放可能でないことを示します。

size

TT_INTEGERNOT NULL

コマンド・キャッシュでこのコマンドに割り当てられた領域の合計(バイト)。

owner

TT_CHAR (31) NOT NULL

コマンドを作成したユーザー。

queryText

TT_VARCHAR (409600) NOT NULL

現在のコマンドの完全なSQLテキスト。

fetchCount

TT_BIGINT

この文のために行われたフェッチ実行の合計数。フェッチ数はTT_PREFETCH_COUNTによって決まります。プリフェッチ数には、コミット読取り分離モードのデフォルト値5およびシリアライズ可能なモードのデフォルト値128があります。

startTime

TT_TIMESTAMP

文が最後に実行された時刻。値の形式はYYYY-MM-DD HH:MI:SS.FFFです。

maxExecuteTime

NUMBER

この文の最大ウォール・クロック実行時間が秒単位で表示されます。

lastExecuteTime

NUMBER

コマンドの最後に測定された実行時間が秒単位で表示されます。

minExecuteTime

NUMBER

SqlCmdSampleFactor > 0の場合、秒単位の最小実行時間となり、それ以外は0.0となります。

例

現在有効なすべてのコマンドに関する情報をttIsqlに表示するには、次のように実行します。

Command> call ttSQLCmdCacheInfo2;
...

ttSQLCmdCacheInfoとttSQLCmdCacheInfo2の出力の違いを次の例に示します。

Command> call ttSQLCmdCacheInfo;
...
< 51635464, 2048, 12, 12, 0, 1, 3056, SYS , delete from
sys.idl_sb4$ where obj#=:1 and part=:2 >
...

Command> call ttSQLCmdCacheInfo2;
...
< 51635464, 2048, 12, 12, 0, 1, 3056, SYS, delete
from sys.idl_sb4$ where obj#=:1 and part=:2, 0,
2013-10-28 16:47:09.173000, 0, 0,
0 >
...

関連項目

ttSQLCmdCacheInfo
ttSQLCmdCacheInfoGet

ttSQLCmdCacheInfoGet

説明

このプロシージャは、TimesTen SQLコマンド・キャッシュのコマンドに関する情報を表示します。

必要な権限

このプロシージャには、権限は必要ありません。

構文

ttSQLCmdCacheInfoGet()

パラメータ

ttSQLCmdCacheInfoGetにパラメータはありません。

結果セット

ttSQLCmdCacheInfoGetは次の結果セットを返します。

列

データ型

説明

cmdCount

TT_INTEGERNOT NULL

キャッシュ内のコマンドの数。

freeableCount

TT_INTEGERNOT NULL

その時点でサブデーモンによってガベージ収集される解放可能なコマンドの数。この数は、コマンド情報を調べることによって取得されます。

size

TT_BIGINTNOT NULL

キャッシュされたすべてのコマンドを格納するために割り当てられた現在の領域の合計(バイト単位)。

例

コマンドの数、解放可能なコマンドの数およびコマンド・キャッシュに割り当てられた領域の合計を表示するには、次のように実行します。

Command> call ttSQLCmdCacheInfoGet;
< 5,4,12316 >
1 row found

関連項目

ttSQLCmdCacheInfo
ttSQLCmdCacheInfo2

ttSQLCmdQueryPlan

説明

このプロシージャは、TimesTen SQLコマンド・キャッシュのSQL文のすべての詳細なランタイム問合せ計画を返します。引数を指定しないと、このプロシージャはTimesTenキャッシュのすべての有効なコマンドの問合せ計画を表示します。コマンドが無効である場合には、エラーが返され、問合せおよび構文の問題を指摘するテキストが表示されます。

必要な権限

このプロシージャには、ADMIN権限が必要です。

構文

ttSQLCmdQueryPlan([sqlCmdID])

パラメータ

ttSQLCmdQueryPlanには、次のオプションのパラメータがあります。

パラメータ

データ型

説明

sqlCmdID

32-bitシステムの場合はTT_INTEGER
64-bitシステムの場合はTT_BIGINT

TimesTenコマンド・キャッシュでのSQLコマンドの一意の識別子。値が指定されない場合、TimesTenキャッシュのすべての有効なコマンドの問合せ計画を表示します。

結果セット

ttSQLCmdQueryPlanは次の結果セットを返します。

列

データ型

説明

sqlCmdID

32-bitシステムの場合はTT_INTEGER NOT NULL
64-bitシステムの場合はTT_BIGINT NOT NULL

TimesTenコマンド・キャッシュでのコマンドの一意の識別子。

queryText

TT_VARCHAR(409600)

現在のコマンドのSQLテキストの最初の1024文字。

step

TT_INTEGER

このランタイム問合せ計画の現在の処理のステップ数。

level

TT_INTEGER

このランタイム問合せ計画の現在の処理のレベル数。

operation

TT_CHAR(31)

このランタイム問合せ計画の現在のステップの処理名。

tblName

TT_CHAR(31)

このステップに使用されている表の名前(存在する場合)。
表名の指定にシノニムは使用できません。

tblOwnerName

TT_CHAR(31)

このステップに使用されている表の所有者の名前(存在する場合)。

indexName

TT_CHAR(31)

このステップに使用されている索引の名前(存在する場合)。

indexedPred

TTVARCHAR(1024)

このステップでは、索引が使用される場合、索引付けされた条件が出力されます(使用可能な場合)。式をすべて出力できないため、出力が断片化および切り捨てられる可能性があります。"..."は、式の未終了の部分を表します。

nonIndexedPred

TT_VARCHAR(1024)

このステップでは、索引付けされていない条件が使用される場合、その索引付けされていない条件が出力されます(使用可能な場合)。式をすべて出力できないため、出力が断片化および切り捨てられる可能性があります。"..."は、式の未終了の部分を表します。

例

SQLCmdID 528078576の問合せ計画を表示するには、次のコマンドを実行します。

Command> call ttSqlCmdQueryPlan(528078576);
< 528078576, select * from t1 where 1=2 or (x1 in
(select x2 from t2, t5 where y2 in (select y3 from t3))
and y1 in (select x4 from t4)), <NULL>, <NULL>, <NULL>,
<NULL>, <NULL>, <NULL>, <NULL>, <NULL> >
< 528078576, <NULL>, 0, 4, RowLkSerialScan , T1 , TTUSER , , , >
< 528078576, <NULL>, 1, 7, RowLkRangeScan , T2 , TTUSER , I2 , , >
< 528078576, <NULL>, 2, 7, RowLkRangeScan , T5 , TTUSER , I2 , , >
< 528078576, <NULL>, 3, 6, NestedLoop , , , , , >
< 528078576, <NULL>, 4, 6, RowLkRangeScan , T3 , TTUSER , I1 ,
( (Y3=Y2; ) ) , >
< 528078576, <NULL>, 5, 5, NestedLoop , , , , , >
< 528078576, <NULL>, 6, 4, Filter , , , , , X1 = X2; >
< 528078576, <NULL>, 7, 3, NestedLoop(Left OuterJoin) , , , , , >
< 528078576, <NULL>, 8, 2, Filter , , , , , >
< 528078576, <NULL>, 9, 2, RowLkRangeScan , T4 , TTUSER , I2 , ,
Y1 = X4; >
< 528078576, <NULL>, 10, 1, NestedLoop(Left OuterJoin) , , , , , >
< 528078576, <NULL>, 11, 0, Filter , , , , , >
13 rows found.

すべての有効な問合せの問合せ計画を表示するには、次のようにttSqlCmdQueryPlanの引数を省略します。

< 528079360, select * from t7 where x7 is not null
or exists (select 1 from t2,t3 where not 'tuf' like 'abc'),
<NULL>, <NULL>, <NULL>, <NULL>, <NULL>, <NULL>, <NULL>, <NULL> >
< 528079360, <NULL>, 1, 3, RowLkRangeScan  , T2
, TTUSER  , I2 , , NOT(LIKE( tuf ,abc ,NULL )) >
< 528079360, <NULL>, 2, 3, RowLkRangeScan  , T3  , TTUSER  ,
I2  , , >
< 528079360, <NULL>, 3, 2, NestedLoop  ,  ,  ,  , , >
< 528079360, <NULL>, 4, 1, NestedLoop(Left OuterJoin) ,    ,    ,    , , >
< 528079360, <NULL>, 5, 0, Filter    ,    ,    ,    , , X7 >
< 527576540, call ttSqlCmdQueryPlan(527973892), <NULL>, <NULL>,
<NULL>, <NULL>, <NULL>, <NULL>, <NULL>, <NULL> >
< 527576540, <NULL>, 0, 0, Procedure Call  ,  ,  ,  , , >
< 528054656, create table t2(x2 int,y2 int, z2 int), <NULL>,
<NULL>, <NULL>, <NULL>, <NULL>, <NULL>, <NULL>, <NULL> >
< 528066648, insert into t2 select * from t1, <NULL>, <NULL>,
<NULL>, <NULL>, <NULL>, <NULL>, <NULL>, <NULL> >
< 528066648, <NULL>, 0, 0, Insert  , T2  , TTUSER  ,  , , >
< 528013192, select * from t1 where exists (
select * from t2 where x1=x2) or y1=1,
<NULL>, <NULL>, <NULL>, <NULL>, <NULL>, <NULL>, <NULL>, <NULL> >
< 528061248, create index i1 on t3(y3), <NULL>, <NULL>, <NULL>,
<NULL>, <NULL>, <NULL>, <NULL>, <NULL> >
< 528070368, call ttOptSetOrder('t3 t4 t2 t1'), <NULL>, <NULL>,
<NULL>, <NULL>, <NULL>, <NULL>, <NULL>, <NULL> >
< 528070368, <NULL>, 0, 0, Procedure Call  ,  ,  ,  , , >
< 528018856, insert into t2 select * from t1, <NULL>, <NULL>,
<NULL>, <NULL>, <NULL>, <NULL>, <NULL>, <NULL> >
< 527573452, call ttsqlCmdCacheInfo(527973892), <NULL>, <NULL>,
<NULL>, <NULL>, <NULL>, <NULL>, <NULL>, <NULL> >
< 527573452, <NULL>, 0, 0, Procedure Call   ,    ,    ,    , , >
….. /* more rows here */

ttSQLExecutionTimeHistogram

説明

ttSQLExecutionTimeHistogram組込みプロシージャは、単一のSQLコマンド、またはコマンド・キャッシュでサンプリングを有効にしている場合はすべてのSQLコマンドのいずれかのSQL実行時間のヒストグラムを返します。

必要な権限

このプロシージャには、ADMIN権限が必要です。

構文

ttSQLExecutionTimeHistogram(sqlCommandID)

パラメータ

ttSQLExecutionTimeHistogramには、次のオプション・パラメータがあります。

パラメータ

データ型

説明

sqlCommandID

32-bitシステムの場合はTT_INTEGER
64-bitシステムの場合はTT_BIGINT

TimesTenコマンド・キャッシュでのSQLコマンドの一意の識別子。値が指定されない場合、TimesTenコマンド・キャッシュの現在のすべてのコマンドに関する情報を表示します。

結果セット

ttSQLExecutionTimeHistogramは、次の結果セットを返します。

列

データ型

説明

histogramSamples

TT_BIGINT

データベースが起動されてからまたはttStatsConfig組込みプロシージャを使用して統計がリセットされてからの、SQLコマンド実行時間操作が測定された回数。

totalExecuteTime

NUMBER

サンプリング時の蓄積された実実行時間(秒)。

bucketUpperBound

NUMBER

実行時間の上限(秒)。

count

TT_BIGINT

ExecutionTimeLimit以下であり、前の行または0からのExecutionTimeLimitを超える時間でのSQLコマンドの数。

例

次の例では、ttSQLExecutionTimeHistogram組込みプロシージャの出力を示しています。

次のttSQLExecutionTimeHistogram組込みプロシージャの例は、合計1919文が実行されていることを示しています。1919すべての文の実行にかかった合計時間は、1.090751秒でした。この例ではSQL文が次の時間枠で実行されたことを示しています。

- 278文が.00001562秒以下の時間枠の間に実行された。

- 1484文が.00001562秒を超え.000125以下の時間枠の間に実行された。

- 35文が.000125秒を超え.001以下の時間枠の間に実行された。

- 62文が.001秒を超え.008以下の時間枠の間に実行された。

- 60文が.008秒を超え.064以下の時間枠の間に実行された。

Command> call ttSQLExecutionTimeHistogram;
< 1919, 1.090751, .00001562, 278 >
< 1919, 1.090751, .000125, 1484 >
< 1919, 1.090751, .001, 35 >
< 1919, 1.090751, .008, 62 >
< 1919, 1.090751, .064, 60 >
< 1919, 1.090751, .512, 0 >
< 1919, 1.090751, 4.096, 0 >
< 1919, 1.090751, 32.768, 0 >
< 1919, 1.090751, 262.144, 0 >
< 1919, 1.090751, 9.999999999E+125, 0 >
10 rows found.

関連項目

ttStatsConfig
ttSQLCmdCacheInfo2

ttStatsConfig

説明

ttStatsConfig組込みプロシージャは、統計収集およびパラメータを制御します。このプロシージャは、名前と値のペアを入力として取り、名前と値のペアのパラメータに対応する単一行の結果セットを出力します。

必要な権限

このプロシージャには、ADMIN権限が必要です。

構文

ttStatsConfig("param", [value])

パラメータ

ttStatsConfigには、次のパラメータがあります。

パラメータ

データ型

説明

param

VARCHAR2(50) NOT NULL

TimesTenコマンド・キャッシュでのSQLコマンドの一意の識別子。

value

VARCHAR2(200)

指定したコマンドの値。値が指定されない場合、TimesTenキャッシュのすべての有効なコマンドの問合せ計画を表示します。

結果セット

ttStatsConfigは、次の結果セットを返します。

列

データ型

説明

param

VARCHAR2(50) NOT NULL

TimesTenコマンド・キャッシュでのSQLコマンドの一意の識別子。

value

VARCHAR2(200)

指定したコマンドの値。値を指定しなかった場合、コマンドの現在の値になります。

パラメータ/値のペア

次の名前/値のペアが結果セットで返されます。

名前

値

説明

SQLCmdSampleFactor

0 <= value <= 60000

SQLコマンドのサンプルが取られる頻度。デフォルトは0です。値0は、サンプリングがオフになっていることを示します。0を超える値は、SQL文の間隔でサンプルが取られることを示します。たとえば、値10は、10番目のSQL文の実行ごとに実行の実時間が取得されます。

ConnSampleFactor

C,S
0<=C<=Connections

0<=S<=60000

TimesTenコマンド・キャッシュでのSQLコマンドの一意の識別子。値を指定しない場合、TimesTenではコマンドの現在の値が表示されます。

SQLCmdHistogramReset

0または0以外

指定された値が0(ゼロ)以外の場合、既存のSQL実行時間統計がリセットされます。

StatsLevel

NONE
TYPICAL

ALL

BASIC

データベースおよびオペレーティング・システム統計の収集レベルを指定します。TimesTenでは、これらの統計を自己管理の意思決定を含む様々な目的で収集します。
StatsLevelパラメータをNONEに設定すると、システム統計の収集を無効にします。

デフォルト設定のTYPICALでは、データベースの自己管理機能に必要なすべての主要統計の収集が行われ、全体的に最良のパフォーマンスが得られます。このデフォルト値は、多くの環境に適しています。

StatsLevelパラメータがALLに設定された場合、TYPICAL設定で収集された統計のセットに付加的な統計が追加されます。付加的な統計とは、時限オペレーティング・システム統計と計画実行統計です。

StatsLevelパラメータをBASICに設定すると、多くのTimesTen機能で必要となる多くの重要な統計の収集が無効にされます。

例

各コマンドをサンプリングします。

Command> call ttStatsConfig('SqlCmdSampleFactor',1);
< SQLCMDSAMPLEFACTOR, 1 >
1 row found.

サンプリングをチェックします。

Command> call ttStatsConfig('SqlCmdSampleFactor');
< SQLCMDSAMPLEFACTOR, 1 >
1 row found.

接続1で5文ごとにサンプリングします。

Command> call ttStatsConfig('ConnSampleFactor', '1,5');
< CONNSAMPLEFACTOR, 1,5 >
1 row found.

接続1でのサンプリングをオフにします。

Command> call ttStatsConfig('ConnSampleFactor', '1,0');
< CONNSAMPLEFACTOR, 1,0 >
1 row found.

データ・ストア統計の収集レベルをチェックします。

Command> call ttstatsconfig('StatsLevel');
< STATSLEVEL, TYPICAL >
1 row found.

データ・ストア統計の収集をオフにします。

Command> call ttstatsconfig('StatsLevel','None');
< STATSLEVEL, NONE >
1 row found.

ttTableSchemaFromOraQueryGet

説明

この組込みプロシージャはOracle Databaseの表に対するSELECT問合せを評価し、実行を選択できるCREATE TABLE SQL文を生成します。TimesTen CREATE TABLE文は結果セットの列名とタイプを突き合せます。

このプロシージャはTimesTen表を作成しません。表スキーマを識別する文のみを返します。

詳細と使用法の情報については、『Oracle TimesTen In-Memory Databaseオペレーション・ガイド』のOracle DatabaseからTimesTen表へのデータのロードに関する説明を参照してください。

必要な権限

このプロシージャには、権限は必要ありません。セッション・ユーザーは、Oracle Databaseに対して問合せを実行するために必要なすべての権限を持っている必要があります。

構文

ttTableSchemaFromOraQueryGet(['tblOwner'], 'tblName', 'Query')

パラメータ

ttTableSchemaFromOraQueryGetには、次のパラメータがあります。

パラメータ

データ型

説明

tblOwner

TT_CHAR (30)

TimesTen表の所有者(オプション)。指定しない場合は、接続IDが使用されます。

tblName

TT_CHAR(30) NOT NULL

CREATE TABLE文の表名。
指定するTimesTen表はシステム表、シノニム、ビュー、マテリアライズド・ビューまたはマテリアライズド・ビューの詳細表、グローバル一時表、キャッシュ・グループ表とすることはできません。

Query

TT_VARCHAR (409600) NOT NULL

表の列定義を導出する、Oracle Databaseに対するSELECT問合せ。
SELECTリストのすべての式には、列別名を指定する必要があります。指定しない場合、実装に依存した列名が想定され、式は評価されません。

結果セット

ttTableSchemaFromOraQueryGetは次の結果セットを返します。

列

データ型

説明

createSQL

TT_VARCHAR (409600) NOT NULL

Oracle DatabaseのSELECT問合せの結果セットを突き合せるCREATE TABLE文。

例

次の例ではCREATE TABLE文が返され、TimesTen HR.EMPLOYEES表が作成されます。この表のすべての列はOracle DatabaseのHR.EMPLOYEES表にあります。

Command> call ttTableSchemaFromOraQueryGet('hr','employees',
'SELECT * FROM hr.employees');
< CREATE TABLE "HR"."EMPLOYEES" (
"EMPLOYEE_ID" number(6,0) NOT NULL,
"FIRST_NAME" varchar2(20 byte),
"LAST_NAME" varchar2(25 byte) NOT NULL,
"EMAIL" varchar2(25 byte) NOT NULL,
"PHONE_NUMBER" varchar2(20 byte),
"HIRE_DATE" date NOT NULL,
"JOB_ID" varchar2(10 byte) NOT NULL,
"SALARY" number(8,2),
"COMMISSION_PCT" number(2,2),
"MANAGER_ID" number(6,0),
"DEPARTMENT_ID" number(4,0)
) >
1 row found.

注意

Oracle Databaseに対する問合せはパラメータ・バインディングを持つことができません。

問合せにOracle Databaseに関する記述がない場合(構文エラーなど)、TimesTenはエラーを返します。

出力列タイプにTimesTenの一致タイプがない場合、TimesTenは警告および列定義の次の行を出力します。>>>>column_name column_type /* reason */

Oracle Databaseへの問合せでTimesTenでサポートされていないタイプが出力された場合、TimesTenがサポートするタイプに出力を明示的に変更するために、SELECTリストでCAST句を追加できます。SELECTリストの式について、それぞれ列別名を指定できます。

Oracle Databaseに対する問合せにLOB出力がある場合、VAR型にマップされます。

ttVersion

説明

ttVersionユーティリティは、リリース番号、プラットフォーム、インスタンス名、インスタンス管理者、インスタンス・ホーム・ディレクトリ、デーモン・ホーム・ディレクトリ、ポート番号およびビルド・タイムスタンプなどの、TimesTenリリース情報を表示します。次のように様々な出力レベルを指定できます。

- 出力を簡略形式で表示するには、オプションなしでttVersionを指定します。

- 出力を拡張形式で表示するには、-mオプションを指定します。

- 特定の属性の出力のみを表示するには、属性を指定します。

必要な権限

このプロシージャには、権限は必要ありません。

構文

ttVersion()

パラメータ

ttVersionにパラメータはありません。

結果セット

ttVersionは次の結果セットを返します。

列

データ型

説明

major1

TT_INTEGERNOT NULL

メジャー・リリース番号。インフラストラクチャおよび機能に重要な変更が加えられたリリースであることを示します。

major2

TT_INTEGERNOT NULL

2番目のメジャー・リリース番号。新たな機能変更が加えられたものの、インフラストラクチャには変更がないバージョンであることを示します。

minor

TT_INTEGERNOT NULL

マイナー・リリース番号。前回のメンテナンス・リリース以降のすべてのバグ修正を含むリリースであることを示します。

patch

TT_INTEGERNOT NULL

マイナーなバグ修正を施したリリースであることを示します。

portpatch

TT_INTEGERNOT NULL

特定のプラットフォームに対してパッチ修正を施したリリースであることを示します。

例

CALL ttVersion( );
<11, 2, 2 , 5, 0>
1 row found.

この場合、TimesTenリリース番号は11.2.2.5.0です。

ttWarnOnLowMemory

説明

このプロシージャを使用すると、現在の接続で実行された処理で割り当てられたメモリーが少ない場合に警告が返されるようにアプリケーションで指定できます。値を設定した場合、メモリーが割り当てられる処理で、総メモリーの使用量が接続のしきい値(接続属性PermWarnThresholdおよびTempWarnThresholdで指定)を超えると、警告が返されます。

必要な権限

このプロシージャには、権限は必要ありません。

構文

ttWarnOnLowMemory(permanent, temporary)

パラメータ

ttWarnOnLowMemoryには、次のパラメータがあります。

パラメータ

データ型

説明

permanent

TT_INTEGERNOT NULL

1: 永続データ・パーティションに対する警告を有効化
0: 永続データ・パーティションに対する警告を無効化

temporary

TT_INTEGERNOT NULL

1: 永続データ・パーティションに対する警告を有効化
0: 永続データ・パーティションに対する警告を無効化

結果セット

ttWarnOnLowMemoryは結果を返しません。

例

CALL ttWarnOnLowMemory(1, 0);

永続データ・パーティションに対してのみ、メモリーが少ない場合の警告を有効にします。

注意

デフォルトでは、TimesTenは、いずれのパーティションに対してもメモリーが少ない場合の警告を発行しません。これらの警告を受け取る必要のあるアプリケーションでは、このプロシージャをコールする必要があります。このプロシージャは、接続固有であるため、警告を受け取る必要のある接続ごとに発行する必要があります。また、現在の設定は、後続の接続では適用されません。

ttXactIdGet

説明

このプロシージャは、ロック・メッセージを解釈するためのトランザクションID情報を返します。ttXactIdGetの2つの結果列を組み合せて使用すると、データベースのトランザクションを一意に識別できます。個々に使用される列は対象になりません。結果は、トランザクション情報の他のソースと相関させる目的にのみ使用します。数値に厳密なパターンはありません。

必要な権限

このプロシージャには、権限は必要ありません。

構文

ttXactIdGet()

パラメータ

ttXactIdGetにパラメータはありません。

結果セット

ttXactIdGetは次の結果セットを返します。

列

データ型

説明

xactID

TT_INTEGER

接続ID。

counter

TT_BIGINT

同じトランザクションIDの連続するトランザクションを区別するために使用される、累増する数値。

例

Command > automcommit 0;
Command > call ttXactIdGet;
<2,11>
1 row found
Command > commit;
Command > call ttXactIdGet
<3, 12>
1 row found

注意

出力は、ロック・エラー・メッセージで表示された値およびttXactAdminロック情報の出力と相互に関連があります。

関連項目

ttXactAdmin
『Oracle TimesTen In-Memory Database C開発者ガイド』のttXactIdRollbackに関する説明

ttXlaBookmarkCreate

説明

このプロシージャは、指定されたブックマークを作成します。

必要な権限

このプロシージャには、XLA権限が必要です。

構文

ttXlaBookmarkCreate('bookmark', 'replicated')

パラメータ

ttXlaBookmarkCreateには、次のパラメータがあります。

パラメータ

データ型

説明

bookmark

TT_CHAR(31) NOT NULL

作成するブックマークの名前。

replicated

BINARY(1)

レプリケートされないブックマークの場合は0x00またはNULL(同等の値)(デフォルト設定)。
レプリケートされるブックマークの場合は0x01。

NULLの場合は、レプリケートされないブックマークが使用されます。

結果セット

ttXlaBookmarkCreateは結果を返しません。

例

レプリケートされないブックマークの場合は、次のコマンドを実行します。

Command > call ttXlaBookmarkCreate('mybookmark');

または

Command> call ttxlabookmarkcreate('mybkmk2',0x00);

レプリケートされるブックマークの場合は、次のコマンドを実行します。

Command > call ttXlaBookmarkCreate('mybookmark', 0x01);

レプリケートされるXLAブックマークなどXLAブックマークの詳細は、『Oracle TimesTen In-Memory Database C開発者ガイド』のXLAブックマークに関する説明を参照してください。

注意

XLAハンドルを初期化するttXlaPersistOpen関数のコール時にブックマークを作成することもできます。『Oracle TimesTen In-Memory Database C開発者ガイド』のブックマークの作成または再利用に関する説明を参照してください。

関連項目

ttXlaSubscribe
ttXlaUnsubscribe
ttXlaBookmarkDelete

ttXlaBookmarkDelete

説明

このプロシージャは、指定されたブックマークを削除します。使用中のブックマークは削除できません。

必要な権限

このプロシージャには、XLA権限が必要です。

構文

ttXlaBookmarkDelete('bookmark')

パラメータ

ttXlaBookmarkDeleteには、次のパラメータがあります。

パラメータ

データ型

説明

bookmark

TT_CHAR(31) NOT NULL

削除するブックマークの名前。

結果セット

ttXlaBookmarkDeleteは結果を返しません。

例

Command > call ttXlaBookmarkDelete('mybookmark');

注意

XLAブックマークによってサブスクライブされている表を削除する前に、すべてのXLAブックマークを削除するか、XLA追跡によるサブスクライブを解除する必要があります。

関連項目

ttXlaBookmarkCreate
ttXlaSubscribe
ttXlaUnsubscribe

ttXlaSubscribe

説明

このプロシージャは、表の永続XLA追跡を設定します。指定するブックマークが使用中の場合、このプロシージャは実行できません。

必要な権限

このプロシージャには、XLA権限が必要です。

構文

ttXlaSubscribe('tblName', 'bookmark')

パラメータ

ttXlaSubscribeには、次のパラメータがあります。

パラメータ

データ型

説明

tblName

TT_CHAR(61) NOT NULL

追跡する表の名前。
表名の指定にシノニムは使用できません。

bookmark

TT_CHAR(31) NOT NULL

アプリケーションがこの表を追跡するために使用するブックマークの名前。

結果セット

ttXlaSubscribeは結果を返しません。

例

Command > call ttXlaSubscribe ('SALLY.ACCTS', mybookmark);

注意

または、ttXlaTableStatus関数は、現行のブックマークを指定した表への更新にサブスクライブするか、表に関連付けられたDMLレコードを現行のブックマークがすでに監視しているかどうかを判断します。『Oracle TimesTen In-Memory Database C開発者ガイド』の更新の監視を行う表の指定に関する説明を参照してください。

関連項目

ttXlaBookmarkCreate
ttXlaBookmarkDelete
ttXlaUnsubscribe

ttXlaUnsubscribe

説明

このプロシージャは、表の永続XLA追跡を停止します。指定するブックマークが使用中の場合、このプロシージャは実行できません。

必要な権限

このプロシージャには、XLA権限が必要です。

構文

ttXlaUnsubscribe('tblName', 'bookmark')

パラメータ

ttXlaUnsubscribeには、次のパラメータがあります。

パラメータ

データ型

説明

tblName

TT_CHAR(61) NOT NULL

XLA追跡を停止する表の名前。
表名の指定にシノニムは使用できません。

bookmark

TT_CHAR(31) NOT NULL

アプリケーションがこの表を追跡するために使用するブックマークの名前。

結果セット

ttXlaSubscribeは結果を返しません。

例

Command > call ttXlaUnsubscribe ('SALLY.ACCTS', mybookmark);

注意

XLAブックマークによってサブスクライブされている表を削除する前に、すべてのXLAブックマークを削除するか、XLA追跡によるサブスクライブを解除する必要があります。

関連項目

ttXlaBookmarkCreate
ttXlaBookmarkDelete
ttXlaSubscribe

3 ユーティリティ

この章では、まずTimesTenユーティリティの概要を説明し、その後にリファレンス情報を示します。

- 概要

- ユーティリティに必要な認証および認可

概要

TimesTenユーティリティのオプションでは、1文字のオプションを除いて、大/小文字は区別されません。-connstrと-connStrは同じ意味で使用できます。ただし、-vと-Vはそれぞれ一意のオプションです。

すべてのユーティリティでは、成功した場合は0が返され、エラーが発生した場合は0以外が返されます。

注意:
この章に示されているユーティリティ名およびオプションでは、大/小文字は区別されません。これらは、例および構文の記述をわかりやすくするために、大/小文字混在で示されています。

ユーティリティに必要な認証および認可

次の項では、ユーティリティに必要な認証および許可について説明します。

- ユーティリティに必要なユーザー認証

- ユーティリティの実行に必要な権限

ユーティリティに必要なユーザー認証

パスワードを必要とするすべてのユーティリティでは、パスワードを入力するように要求されます。

接続文字列によって、または指定されたDSNのODBCINIファイル内で、UID接続属性は指定されているがPWD属性が指定されていない場合は、TimesTenによってパスワードの入力が要求されます。明示的に要求された場合には、入力内容はコマンドラインに表示されません。

一般に、UID接続属性が指定されていない場合、UIDはオペレーティング・システムで識別されるユーザー名とみなされ、TimesTenでパスワードを入力するように求められることはありません。

ユーティリティでDSN、接続文字列またはデータベース・パスをパラメータとして使用する場合は、コマンドラインの末尾に値を指定します。

注意:
セキュリティの理由から、コマンドラインでのPWD値の設定は推奨していません。

ユーティリティの実行に必要な権限

特定のTimesTenコマンドライン・ユーティリティには権限が必要です。この章の各ユーティリティには、実行に必要な権限が示されています。インスタンス管理者以外のユーザーでユーティリティを実行しようとした場合に、データベースがメモリーにロードされていないと、「database not loaded」というエラーが表示されることがあります。この場合、TimesTenはユーザーの権限を確認できません。

そのため、権限を必要とするユーティリティは、インスタンス管理者として実行するか、またはデータベースがロードされている間に実行する必要があります。

ttAdmin

説明

このユーティリティを使用すると、次のことができます。

- RAMからデータベースを自動または手動でロードおよびアンロードするポリシーを指定する。

- 指定したデータベースのレプリケーション・エージェントを自動または手動で開始および停止するポリシーを指定する。

- Oracle Database表からデータをキャッシュするために、TimesTenキャッシュ・エージェントの開始と停止を行う。キャッシュ・エージェントは、TimesTenデータベースのために、Oracle Databaseへのアクセスを行うプロセスです。また、TimesTenデータベース内のキャッシュ・グループのエージングと自動リフレッシュも行います。いずれのキャッシュ機能も、キャッシュ・エージェントを開始してから使用する必要があります。キャッシュ・オプションを使用するには、DSNにOracleNetServiceNameの値を指定する必要があります。

必要な権限

このユーティリティでは、データベースを問い合せるための権限は必要ありません。

レプリケーション・オプションにはADMIN権限が必要です。

キャッシュ・オプションには、CACHE_MANAGER権限が必要です。

それ以外のオプションには、ADMIN権限が必要です。

構文

ttAdmin {-h | -help | -?}

ttAdmin {-V | -version}

ttAdmin [-ramPolicy always|manual|inUse [-ramGrace secs] ]
[-ramLoad] [-ramUnload]
[-autoreload | -noautoreload]
[-repPolicy always|manual|norestart]
[-reqpQueryThresholdGet]
[-reqpQueryThresholdSet seconds]
[-repStart | -repStop]
[[-cacheUidGet] |
[-cacheUidPwdSet -cacheUid uid [-cachePwd pwd]] |
[-cachePolicy always|manual|norestart] |
[-cacheStart] |
[-cacheStop [-stopTimeout seconds]]]
[-query]
{-connStr connection_string | DSN}

オプション

ttAdminには次のオプションがあります。

オプション

説明

-connStr connection_string

データベース名、サーバー名とDSN(必要に応じて)および関連する接続属性を含むODBC接続文字列。

DSN

管理するデータベースのODBCデータソース名を指定します。

-h -help
-?

使用方法のメッセージを出力して終了します。

-autoreload | -noautoreload

-noautoreloadに設定すると、無効化の後、TimesTenがデータベースを自動的にリロードすることはありません。
-autoreloadに設定すると、無効化の後、TimesTenはデータベースをリロードします。これは、デフォルトの動作です。

-cachePolicy

データベースに対してキャッシュ・エージェントを開始するタイミングを決定するために使用するポリシーを定義します。
always: キャッシュ・エージェントはデータベースに対して常時実行されます。このオプションは、キャッシュ・エージェントをただちに起動し、デーモンが再起動されると、キャッシュ・エージェントが再起動されます。

manual(デフォルト): キャッシュ・エージェントを手動で起動および停止する必要があります。

norestart: エラーが発生した後、データベースに対するキャッシュ・エージェントは再起動されません。

このオプションには、CACHE_MANAGER権限が必要です。

-cacheStart

データベースに対してキャッシュ・エージェントを開始します。このオプションには、CACHE_MANAGER権限が必要です。

-cacheStop

データベースに対するキャッシュ・エージェントを停止します。キャッシュ・グループを削除または変更した直後にキャッシュ・エージェントを停止しないでください。かわりに、少なくとも2分間待機します。待機しないと、キャッシュ・エージェントは、AUTOREFRESH機能で使用されたOracle Databaseオブジェクトをクリーンアップすることができません。このオプションには、CACHE_MANAGER権限が必要です。

-cachePwd

自動リフレッシュ・キャッシュ・グループおよび非同期ライトスルー・キャッシュ・グループを管理するキャッシュ管理ユーザーIDに関連付けられたパスワード。キャッシュ管理ユーザーは、拡張された権限を持っています。詳細は、『Oracle TimesTen Application-Tier Database Cacheユーザーズ・ガイド』のOracle Databaseユーザーへの権限の付与に関する説明を参照してください。このオプションには、CACHE_MANAGER権限が必要です。

-cacheUid

キャッシュ管理ユーザーID。キャッシュ管理ユーザーは、自動リフレッシュ・キャッシュ・グループおよび非同期ライトスルー・キャッシュ・グループを管理します。キャッシュ管理ユーザーは、拡張された権限を持っています。このオプションには、CACHE_MANAGER権限が必要です。
詳細は、『Oracle TimesTen Application-Tier Database Cacheユーザーズ・ガイド』のOracle Databaseユーザーへの権限の付与に関する説明を参照してください。

-cacheUidGet

指定されたデータベースの現在のキャッシュ管理ユーザーIDを取得します。このオプションには、CACHE_MANAGER権限が必要です。

-cacheUidPwdSet

指定されたデータベースのキャッシュ管理ユーザー名およびパスワードを設定します。このオプションには、CACHE_MANAGER権限が必要です。-cacheUidおよび-cachePwdオプションとともに設定する必要があります。このオプションの注意事項は、次のとおりです。

- 新しいデータベースごとにキャッシュ管理ユーザーIDおよびパスワードを1回だけ指定します。

- DDLReplicationLevelのすべてのレベルにおいて、キャッシュ・エージェントまたはレプリケーション・エージェントが実行されている場合は、-cacheUidPwdSetオプションを使用してキャッシュ管理ユーザー名およびパスワードを設定できます。詳細は、『Oracle TimesTen In-Memory Database開発者および管理者ガイド』のレプリケーションで使用されるユーザー名またはパスワードの変更に関する説明を参照してください。

- キャッシュ管理ユーザーIDは、データベースにキャッシュ・グループがある間はリセットできません。キャッシュ管理パスワードはいつでも変更できます。

-query

名前付きデータベースに対するポリシー設定のサマリーを表示します。

-ramGrace secs

-ramPolicyがinUseに設定されている場合にのみ有効です。0 (ゼロ)以外の場合は、最後のアプリケーションがデータベースとの接続を切断した後、データベースはアンロードされる前にsecs秒間、RAMに保持されます。

-ramLoad

-ramPolicyがmanualに設定されている場合にのみ有効です。これにより、データベースがRAMにロードされます。

-ramPolicy policy

データベースをシステムRAMにロードするタイミングを決定するために使用するポリシーを定義します。
always: データベースはシステムRAMに常時存在します。

manual: ユーザーが(ramLoadオプションを使用して)明示的にロードする場合にのみ、データベースはシステムRAMにロードされます。

inUse (デフォルト): データベースが使用中(アプリケーションの接続時)の場合にのみシステムRAMにロードされます。-ramGraceオプションを使用して、このポリシーの動作を変更することもできます。このオプションは、一時データベースでは使用できません。一時データベースは手動でのみRAMにロードできます。ポリシーを設定しようとすると、警告が表示されます。

このオプションには、ADMIN権限が必要です。

-ramUnload

-ramPolicyがmanualに設定されている場合にのみ有効です。これにより、データベースがRAMからアンロードされます。

-repPolicy

レプリケーション・エージェントを起動するタイミングを決定するために使用するポリシーを定義します。
always: エージェントはデータベースに対して常時実行されます。このオプションは、レプリケーション・エージェントをただちに起動し、デーモンが再起動されると、レプリケーション・エージェントが再起動されます。

manual(デフォルト): レプリケーション・エージェントを手動で起動および停止する必要があります。

norestart: エラーが発生した後、データベースに対するレプリケーション・エージェントは再起動されません。

このオプションには、ADMIN権限が必要です。

-repQueryThresholdGet

レプリケーション・エージェントが問合せを実行できる最大秒数を返します。この秒数を超えると、警告がサポート・ログに書き込まれ、SNMPトラップがスローされます。
この値を0にすると、警告は送信されません。

このオプションには、ADMIN権限が必要です。

-repQueryThresholdSet

レプリケーション・エージェントが問合せを実行できる最大秒数を指定します。この秒数を超えると、警告がサポート・ログに書き込まれ、SNMPトラップがスローされます。
指定した値は、レプリケーション・エージェントを次に起動したときに有効になります。レプリケーション・エージェントの問合せしきい値は、マテリアライズド・ビューのディテール表に対するSQL実行、ON DELETE CASCADE処理および一部の内部処理に適用されます。

0以上の値である必要があります。

デフォルトは0であり、警告は送信されません。

このオプションには、ADMIN権限が必要です。

-repStart

データベースのレプリケーション・エージェントを起動します。

-repStop

データベースのレプリケーション・エージェントを停止します。

-stopTimeout seconds

seconds秒数内にキャッシュ・エージェントが停止しない場合は、TimesTenデーモンに停止するように指定します。
0を設定すると、デーモンはキャッシュ・エージェントを無期限待機します。デフォルト値は100秒です。

このオプションには、CACHE_MANAGER権限が必要です。

-V | -version

ttAdminのリリース番号を出力し、終了します。

例

パフォーマンスを重視する一部のアプリケーションによって、DSN SalesDataで参照されるデータベースが使用されます。データベースがディスクからRAMにロードされるのをアプリケーションが待機する必要がないように、このデータベースは常時RAMに存在している必要があります。メモリーにデータベースを保持するには、次のように実行します。

ttAdmin -ramPolicy always SalesData

通常、SalesDataデータベースは、RAMに常駐しています。ただし、これは常に使用されるわけではないため、アプリケーションが接続するときにのみロードすることをお薦めします。RAMポリシーを変更するには、次のコマンドを実行します。

ttAdmin -ramPolicy inUse SalesData

SalesDataデータベースをRAMにロードするかどうかを手動で制御し、すぐにロードするには、次のコマンドを実行します。

ttAdmin -ramPolicy manual -ramLoad SalesData

SalesDataデータベースをRAMから手動でアンロードし、そのデータベースに新しいアプリケーションが接続しないようにするには、次のコマンドを実行します。

ttAdmin -ramPolicy manual -ramUnload SalesData

DSN Historyで参照されるデータベースは、常に使用されているわけではありません。これを永続的にRAMにロードしていると、不必要にメモリーを使用します。このデータベースは、長期にわたりアイドル状態にありますが、使用される場合は、連続して複数のユーザーから接続されます。パフォーマンスを向上させるには、アプリケーションからの接続時にデータベースをRAMに格納し、最後のユーザーが切断した後、RAM内でそれを5分間(300秒間)保持するようにします。このRAMポリシーでは、アプリケーションがデータベースに接続している場合には、データベースはRAMに保持されます。このポリシーを設定するには、次のコマンドを実行します。

ttAdmin -ramPolicy inUse -ramGrace 300 History

DSN SalesDataに参照されるデータベースには、Oracle Databaseからキャッシュされたデータが含まれます。SalesData DSN用のキャッシュ・エージェントを開始するには、次のttAdminコマンドを実行します。

ttAdmin -cacheStart SalesData

また、-cachePolicyオプションを使用して、TimesTen Data Managerデーモンに、Data Manager自身が起動するたびにキャッシュ・エージェントを開始させるように設定できます。次のようにします。

ttAdmin -cachePolicy always SalesData

キャッシュ・エージェントの自動開始をオフにするには、次のコマンドを実行します。

ttAdmin -cachePolicy manual SalesData

キャッシュ管理ユーザーIDとパスワードを設定するには、-cacheUidPwdSetフラグを-cacheUidおよび-cachePwdオプションとともに使用します。たとえば、データベースSalesDataのキャッシュ管理ユーザーIDとパスワードを、それぞれscottとtigerにするには、次のコマンドを実行します。

ttAdmin -cacheUidPwdSet -cacheUid scott -cachPwd tiger SalesData

SalesData DSNの現行のキャッシュ管理ユーザーIDを取得するには、次のコマンドを実行します。

ttAdmin -cacheUidGet SalesData

ttAdminによって、次のような出力が表示されます。

Cache User Id: scott
RAM Residence Policy: inUse
Replication Agent Policy: manual
Replication Manually Started: False
Cache Agent Policy: manual
Cache Agent Manually Started: False

注意

TimesTenがユーザー・インスタンスとしてインストールされている場合に、ユーザーが相対パスを使用してデータベースに対してキャッシュ・エージェントを起動しようとすると、TimesTenは実行されている場所に対する相対パスでデータベースを検索し、失敗します。このため、この使用例では相対パスを使用しないでください。たとえば、Windows上でデータベースのパスをDataStore=./dsn1として指定し、コマンドttAdmin -cacheStart dsn1でキャッシュ・エージェントを起動しようとしても、キャッシュ・エージェントはinstall_dir\srv\dsn1でデータベースを検索するため起動しません。UNIXの場合は、/var/TimesTen/instance/のディレクトリを検索します。

自動リフレッシュ(Oracle DatabaseからTimesTenデータベースへの自動伝播)または非同期ライトスルー・キャッシュ・グループを使用する場合は、キャッシュ管理ユーザーIDとパスワードを指定する必要があります。このユーザー・アカウントで、自動リフレッシュおよび非同期ライトスルー処理が実行されます。

Oracle Databaseからデータをロードするには、TimesTenキャッシュ・エージェントを実行している必要があります。このためには、ORACLE_HOME環境変数にOracleインストールのパスが設定されている必要があります。詳細は、『Oracle TimesTen Application-Tier Database Cacheユーザーズ・ガイド』を参照してください。設定するその他の環境変数の詳細は、『Oracle TimesTen In-Memory Databaseインストレーション・ガイド』の環境変数に関する説明を参照してください。

このユーティリティはTimesTen Data Manager DSNでのみ使用できます。TimesTen Client DSNではサポートされていません。

ttAdminが-repStartを指定してコールされたときに、レプリケーション定義が見つからない場合、レプリケーション・エージェントは開始されず、ttAdminによってエラー・メッセージが出力されます。次に例を示します。

$ ttAdmin -repstart repl1
*** [TimesTen][TimesTen 11.2.2.0.0 ODBC Driver][TimesTen]TT8191:
This store (repl1 on my_host) is not involved in a replication scheme --
file "eeProc.c", lineno 11016, procedure "RepAdmin()"
*** ODBC Error = S1000, TimesTen Error = 8191

ttAdminに-ramPolicy alwaysオプションを指定して使用すると、データベースに永続的なシステム接続が作成されます。

一時データベースをサポートする-ramPolicy値は、-ramLoadオプションを同時に使用した-ramPolicy manualオプションのみです。

-repPolicy manual(デフォルト)または-repPolicy alwaysを指定してttAdminを使用する場合は、-ramPolicy alwaysオプションも使用する必要があります。これによって、障害発生後できるかぎり迅速にレプリケーション・エージェントでリカバリが開始されます。

関連項目

ttStatus
ttCachePolicySet
ttCacheUidGet
ttCacheUidPwdSet
ttCacheStart
ttCacheStop

ttAdoptStores

説明

UNIXシステム上で、TimesTenインスタンスのデータベースを、メジャー・リリースが同じでマイナー・リリースが異なる新しいTimesTenインスタンスに移動します。たとえば、TimesTen 11.2.2.5.0のファイルをTimesTen 11.2.2.6.0に移動できます。

注意:
リリース番号の最初の3桁は、メジャー・リリースを表します。リリース番号の最後の2桁がマイナー・リリースです。

このユーティリティは既存のデータベースでTimesのマイナー・リリースをテストするのに有効です。TimesTenの新しいリリースをインストールし、1つ以上のデータベースを新しいリリースに移行して、TimesTenの旧リリースをアンインストールせずにテストできます。

ttAdoptStoresユーティリティは、移行先のインスタンスで実行する必要があります。

必要な権限

このユーティリティは、TimesTenインスタンス管理者が実行する必要があります。インスタンス管理者は、新旧両方のTimesTenインスタンスで同じユーザーである必要があります。

構文

ttadoptstores {-h | -help | -?}
ttadoptstores {-V | -version}
ttadoptstores [-quiet] -dspath path
ttadoptstores [-quiet] -instpath path

オプション

ttAdoptStoresには次のオプションがあります。

オプション

説明

-dspath path

1つのデータベースを移行します。path引数は、データベース・ファイル(拡張子は含みません)のパスであることが必要です。

-h
-help

?

使用方法のメッセージを出力して終了します。

-instpath path

インスタンスの全データベースを移行します。path引数は、デーモンの作業ディレクトリ(infodir)のパスであることが必要です。
使用中のデータベースがある場合は、ユーティリティは変更を行わずに失敗します。操作全体が完了するまで、ソース・インスタンスのデータベースには新規に接続できません。

-quiet

冗長メッセージは返されません。

-V | -version

ttAdoptStoresのリリース番号を出力し、終了します。

例

データベース/my/data/stores/dsを移行するには、次のコマンドを実行します。

ttadoptstores -dspath /my/data/stores/ds

ディレクトリ/opt/TimesTen/instance1のデータベースすべてを移行するには、次のコマンドを実行します。

ttadoptstores -instpath /opt/TimesTen/instance1

注意

一時データベースは移行できません。

移行しようとしているインスタンスがレプリケーション・スキームの一部である場合、ttRepAdmin -duplicateの操作時に、-remoteDaemonPortオプションにポート番号が指定されていないかぎり、移行する側とされる側のレプリケーション・スキームのポート番号は一致している必要があります。通常、レプリケーション・スキームに含まれるインスタンスは、すべて同時に更新する必要があります。

このユーティリティで、sys.odbc.iniのエントリはコピーされません。これらのファイルは手動で移動する必要があります。

ttBackup

説明

データベースのバックアップ・コピーを作成します(これにより、後でttRestoreユーティリティを使用してそのデータベースをリストアできます)。TimesTenのバックアップとリストア機能の概要は、『Oracle TimesTen In-Memory Databaseインストレーション・ガイド』の移行、バックアップおよびリストアに関する説明を参照してください。

必要な権限

このユーティリティには、ADMIN権限が必要です。

接続文字列またはDSNに認証情報が指定されていない場合、続行する前にユーザーIDおよびパスワードの入力が求められます。

構文

ttBackup {-h | -help | -?}
ttBackup {-V | -version}
ttBackup -dir directory [-type backupType]
[-fname fileprefix] [-force]
{-connStr connection_string | DSN}

オプション

ttBackupには次のオプションがあります。

オプション

説明

-connStr connection_string

データベース名、サーバー名とDSN(必要に応じて)および関連する接続属性を含むODBC接続文字列。

DSN

バックアップするデータベースのODBCデータソース名を指定します。

-dir directory

バックアップ・ファイルが格納されるディレクトリを指定します。

-fname fileprefix

バックアップ・ディレクトリのバックアップ・ファイルのファイル接頭辞を指定します。このオプションのデフォルト値は、データベースのODBC定義のDataStoreパラメータのファイル名の部分です。

-force

指定したディレクトリにバックアップを強制的に作成します。そのディレクトリにバックアップが存在している場合は、ttBackupによって上書きされます。このオプションが指定されておらず、指定したディレクトリに前にバックアップしたデータベース以外のデータベースからバックアップを作成する場合、ttBackupは既存のファイルを上書きせずに終了メッセージを返して終了します。

-h -help -?

使用方法のメッセージを出力して終了します。

-type backupType

実行するバックアップの種類を指定します。有効な値は、次のとおりです。
fileFull(デフォルト): directoryおよびfileprefixパラメータで指定されたバックアップ・パスで、ファイルの全体バックアップを実行します。作成されたバックアップは、増分バックアップでは使用できません。

fileFullEnable: directoryおよびfileprefixパラメータで指定されたバックアップ・パスで、ファイルの全体バックアップを実行します。作成されたバックアップは、増分バックアップで使用できます。

fileIncremental: directoryおよびfileprefixパラメータで指定されたバックアップ・パスにデータベースの増分可能バックアップが含まれている場合は、そのバックアップ・パスでファイルの増分バックアップを実行します。それ以外の場合は、エラーが返されます。

fileIncrOrFull: directoryおよびfileprefixパラメータで指定されたバックアップ・パスにデータベースの増分可能バックアップが含まれている場合は、そのバックアップ・パスでファイルの増分バックアップを実行します。それ以外の場合は、データベースのファイルの完全バックアップを実行し、増分可能のマークを付けます。

streamFull: 標準出力するストリーム・バックアップを実行します。

incrementalStop: バックアップを実行しません。directoryおよびfileprefixパラメータで指定されたバックアップ・パスに対して、増分バックアップを無効にします。これにより、増分バックアップでトランザクション・ログ・ファイルが蓄積することを回避します。

-V | -version

ttBackupのリリース番号を出力し、終了します。

例

FastInsデータベースのファイルの完全バックアップをバックアップ・ディレクトリ/users/pat/TimesTen/backupsに対して実行するには、次のコマンドを使用します。

ttBackup -type fileFullEnable -dir /users/pat/TimesTen/backups FastIns

FastInsデータベースをFastIns.backファイルにコピーするには、次のコマンドを実行します。

ttBackup -type streamFull FastIns > FastIns.back

UNIXでFastInsデータベースをバックアップ・テープに保存するには、次のコマンドを実行します。

ttBackup -type streamFull FastIns | dd bs=64k of=/dev/rmt0

origDSNというデータベースをディレクトリ/users/rob/tmpにバックアップし、それをrestoredDSNというデータベースにリストアするには、次のコマンドを実行します。

ttBackup -type fileFull -dir /users/rob/tmp -fname restored origDSN
ttRestore -dir /users/rob/tmp -fname restored restoredDSN

注意

ttBackupユーティリティおよびttRestoreユーティリティは、TimesTenリリース番号とプラットフォーム番号の最初の3つの数字が同じ場合にのみ、データベースのバックアップおよびリストアを行います。たとえば、TimesTenリリース11.2.2.2.0と11.2.2.6.0間ではファイルをバックアップし、リストアできます。リリース11.2.1.9.0と11.2.2.6.0の間ではファイルのバックアップとリストアはできません。ttBulkcpユーティリティまたはCSユーティリティ(UNIXのみ)を使用して、各主要リリースまたは各種オペレーティング・システムにわたってデータベースを移行できます。ttMigrateをttMigrateCS (ttMigrateのクライアント・サーバー・バージョン)とともに使用して、32ビットと64ビットのプラットフォームまたはビット・レベル間でデータベースを移行できます。新しいビット・レベルでデータをリストアする場合、-relaxedUpgradeオプションを使用する必要があります。ビット・レベルを変更する場合、レプリケーション・スキームにデータベースを含めることはできません。『Oracle TimesTen In-Memory Databaseインストレーション・ガイド』の32ビット・プラットフォームと64ビット・プラットフォーム間のデータベースの移動に関する項の例に従います。

増分バックアップが有効になっている場合、TimesTenではトランザクション・ログ・ファイルにバックアップ保持が作成されます。ttLogHolds組込みプロシージャをコールして、この保持に関する情報を確認します。バックアップ保持は、後続の増分バックアップでバックアップするログ・レコードを判断する場合に使用されます。前回の増分バックアップ以降の変更内容のみが更新されます。ただし、バックアップ保持を作成すると、その保持が別の増分バックアップの実行によって進められるまで、または増分バックアップを無効にすることによって削除されるまで、チェックポイント処理時にトランザクション・ログ・ファイルを消去できなくなります。

バックアップ操作の開始後にコミットされたトランザクションは、バックアップに反映されません。

最大で、1つのチェックポイントおよび1つのバックアップを同時にアクティブにできますが、次の制限があります。

- チェックポイントが完了するまでバックアップを待機させる必要はありません。

- 別のバックアップが完了するまでバックアップを待機させる必要があります。

- バックアップが完了するまでチェックポイントを待機させる必要があります。

キャッシュ・グループを含むデータベースは、ttBackupユーティリティを使用して正常にバックアップできます。ただし、そのようなバックアップをリストアする場合は、キャッシュ・グループ内のリストアされたデータが古くなっていたり、バックエンドOracle Databaseのデータと同期していないことがあるため、特別な注意が必要です。詳細は、『Oracle TimesTen Application-Tier Database Cacheユーザーズ・ガイド』のキャッシュ・グループを持つデータベースのバックアップとリストアに関する説明を参照してください。

一時データベースはバックアップできません。

関連項目

ttBulkCp
ttMigrate
ttRestore

ttBulkCp

説明

TimesTen表とASCIIファイル間でデータをコピーします。ttBulkCpには、次の2つのモードがあります。

- コピーイン・モード(ttBulkCp -i)では、1つ以上のASCIIファイル(またはstdin)から、既存のTimesTen表に行がコピーされます。

- コピーアウト・モード(ttBulkCp -o)では、TimesTen表全体が単一のASCII出力ファイル(またはstdout)にコピーされます。

UNIXでは、このユーティリティはTimesTen Data Manager DSNで使用できます。クライアントDSNでは、ttBulkCpCSユーティリティを使用します。このユーティリティは、その実行者であるユーザーが所有するオブジェクトおよび所有者がSELECT権限を持っているオブジェクトのみをコピー・アウトします。ユーティリティを実行している所有者がADMIN権限を持っている場合、ttBulkCpはすべてのオブジェクトをコピー・アウトします。

必要な権限

このユーティリティを使用するには、情報のコピー先となる表に対するINSERT権限が必要です。また、情報のコピー元となる表に対するSELECT権限が必要です。

接続文字列またはDSNに認証情報が指定されていない場合、続行する前にユーザーIDおよびパスワードの入力が求められます。

構文

ttBulkCp {-h | -help | -? | -helpfull}

ttBulkCp {-V | -version}

ttBulkCp -i [-cp numTrans | final] [-d errLevel]
[-e errorFile] [-m maxErrs] [-sc] [-t errLevel]
[-u errLevel] [-v 0|1] [-xp numRows | rollback]
[-Cc | -Cnone] [-tformat timeFormat] [-tsformat timeStampFormat]
[-dformat | -D dateFormat] [-F firstRow] [-L lastRow]
[-N ncharEncoding] [-Q 0|1] [-S errLevel] [-dateMode dateMode]
[-[no]tblLock]{-connStr connection_string | DSN}
[owner.]tableName [dataFile ...]

ttBulkCp -o [-sc] [-v 0|1] [-A 0|1] [-Cc | -Cnone]
[-nullFormat formatStr}
[-tformat timeFormat] [-tsformat timeStampFormat]
[-dateMode dateMode] [-dformat | -D dateFormat]
[-N ncharEncoding] [-noForceSerializable | -forceSerializable]
[-tsprec precision] [-Q 0|1]
{-connStr connection_string | DSN} [owner.]tblName
[dataFile]

オプション

ttBulkCpには次のオプションがあります。

オプション

説明

-Cnone
-Cc

-Cnoneは出力ファイルでのコメントの使用を無効にします。-Ccは、デフォルトのコメント文字をcに設定します。デフォルトのコメント文字を指定しない場合、シャープ記号(#)が使用されます。-Cオプションの値は、\t(タブ)または~ ! @ # % ^ & * ( ) = : ; | < > ? , /のいずれかの文字をとります。このオプションはCOMMENTCHARファイル属性を上書きします。

-connStr connection_string

データベース名、サーバー名とDSN(必要に応じて)および関連する接続属性を含むODBC接続文字列。

DSN

コピーするデータベースのODBCデータソース名を指定します。

-D | -dformat
dateFormat

日付書式を設定します。指定できる固定値の一覧は、「日付、時刻およびタイムスタンプの値」を参照してください。このオプションはDFORMATファイル属性を上書きします。デフォルトはODBCです。
関連項目: -tformatおよび-tsformat。

dataFile

コピーイン・モードでは、表に挿入する行を含む1つ以上のASCIIファイルのパス名を指定します。ファイルを指定しないと、標準入力が使用されます。単一のハイフン(-)は標準入力を意味します。コピーアウト・モードでは、行のコピー先のファイルのパス名を指定します。ファイルを指定しないと、標準出力が使用されます。単一のハイフン(-)は標準出力を意味します。

-dateMode dateMode

ttBulkCpでOracle DatabaseのDATE型が(時間、分および秒フィールドのない)単純な日付として扱われるか、(時間、分および秒フィールドのある)タイムスタンプとして扱われるかを指定します。
コピーイン・モードでは、入力のデフォルトの動作は日付です。

コピーアウト・モードでは、出力のデフォルトの動作はタイムスタンプです。

出力モードで-dateMode dateを選択した場合、1つ以上の日付列に12:00:00 am以外の時間コンポーネントが含まれていると、TimesTenはデータを切り捨て、警告を発行します。

このオプションはDATEMODEファイル属性を上書きします。

-h -help
-?

使用方法についての短いメッセージを出力して終了します。

-helpfull

使用方法についての長いメッセージを出力して終了します。

-i

コピーイン・モードを選択します。

-N ncharEncoding

NCHAR型の入力および出力に使用する文字エンコードを指定します。有効な値はUTF8、UTF-8またはASCIIです。

-o

コピーアウト・モードを選択します。

owner

保存またはロードする表の所有者を指定します。ownerを省略すると、TimesTenは、まずユーザー名で、次にユーザー名SYSで表を検索します。このパラメータでは大/小文字は区別されません。

-Q [0 | 1]

文字列値を二重引用符で囲むかどうかを示します。
0: 文字列を引用符で囲まないことを示します。このマニュアルでは、このモードのことを「引用符なしのモード」と呼びます。

1(デフォルト): 文字列を引用符で囲むことを示し、このオプションはQUOTESファイル属性を上書きします。このマニュアルでは、このモードのことを「引用符付きのモード」と呼びます。

-s c

デフォルトのフィールド区切り文字をcに設定します。デフォルトのフィールド区切り文字を指定しない場合、カンマ(,)が使用されます。-sオプションの値は、\t(タブ)または~ ! @ # % ^ & * ( ) = : ; | < > ? , /のいずれかの文字をとります。このオプションはFSEPファイル属性を上書きします。

tableName

保存またはロードする表の名前を指定します。このパラメータでは大/小文字は区別されません。

-tformat
timeFormat

時刻書式を設定します。指定できる固定値の一覧は、「日付、時刻およびタイムスタンプの値」を参照してください。デフォルト値はODBCです。このオプションはTSFORMATファイル属性を上書きします。
関連項目: -D | -dformatおよび-tsformat。

-tsformat
timestampFormat

タイムスタンプ書式を設定します。指定できる固定値の一覧は、「日付、時刻およびタイムスタンプの値」を参照してください。デフォルト値はDF*TF+FFで、これは、日付書式、時間書式および小数秒を連結したものです。このオプションはTFORMATファイル属性を上書きします。
関連項目: -D | -dformatおよび-tformat。

-V | -version

ttBulkCpのリリース番号を出力し、終了します。

-v [0 | 1]

冗長レベルを設定します。
0 - サマリーを抑制します。

1(デフォルト): 完了時にコピーした行のサマリーを出力します。

次のオプションは、コピーアウト・モード(-o)でのみ使用します。指定した表に対するSELECT権限が必要です。

オプション

説明

-A [0 | 1]

ttBulkCpが出力ファイルの属性行を抑制するかどうかを示します。
0(デフォルト): ttBulkCpは出力ファイルに属性行を書き出すことができます。

1: 属性行の出力を抑制します。

-forceSerializable -noForceSerializable

-forceSerializableオプションは、DSNまたは接続文字列の設定にかかわらず、ttBulkCpでシリアライズ可能な分離が使用されることを示します。これは、デフォルトの動作です。
-noForceSerializableは、DSNまたは接続文字列の分離レベルがttBulkCpで使用されることを示します。

-noForceSerializableオプションを指定した場合に、DSNまたは接続文字列にシリアライズ可能でない分離モードが示されていると、次のような警告が出力に含まれます。

Warning: This output was produced using a
non-serializable isolation level. It may therefore not
reflect a transaction-consistent state of the table.

分離モードの詳細は、『Oracle TimesTen In-Memory Databaseオペレーション・ガイド』のトランザクションの分離レベルに関する説明を参照してください。

-nullFormat formatStr

NULL値の出力書式を指定します。有効な値は、次のとおりです。
null(デフォルト): NULLのフィールドには、NULLという単語が出力されます。

empty: NULLのフィールドには何も出力されません。

空のLOBは、引用符なしのモードではNULLと出力され、引用符付きのモードでは" "と出力されます。これらをコピーすると、NULLと" "のどちらもNULL LOBとして解釈されます。

-tsprec precision

-oオプションとともに使用した場合、タイムスタンプ値がprecisionに切り捨てられます。ttBulkCpでは、小数秒フィールドに最大6桁を入力できます。他のRDBMSを使用してタイムスタンプをコピーする場合、切捨てが必要な場合があります。

次のオプションは、コピーイン・モード(-i)でのみ使用します。指定した表に対するINSERT権限が必要です。

オプション

説明

-cp numTrans
-cp final

コピーインのチェックポイント・ポリシーを設定します。
0の値は、コピー全体が完了した後にも、ttBulkCpはデータベースのチェックポイントを行わないことを示します。

0以外の値は、numTransトランザクションごとに、さらにコピー全体が完了した後に、ttBulkCpがデータベースのチェックポイントを行うことを示します。

finalの値は、コピー全体が完了した場合にのみttBulkCpがデータベースのチェックポイントを行うことを示します。デフォルト値は0です。

定期的なコミットも有効になっている場合にのみ、定期的なチェックポイントを有効にできます。-xpオプションを参照してください。

-d error
-d warn

-d ignore

デフォルトでは、ttBulkCpは、一意列や索引での制約違反が原因で拒否される行を、エラーとはみなしません。
-d error: 制約違反をエラーとみなすことを指定します。重複行は、maxErrs(-mを参照)に対してカウントされ、エラー・ファイル(-eを参照)に記録されます。

-d warn: ttBulkCpは問題の行をエラー・ファイルにコピーするが、エラーとしてはカウントしないことを指定します。

-d ignore(デフォルト): ttBulkCpは重複行を暗黙的に無視することを指定します。

-dの設定にかかわらず、重複行は表に挿入されません。

-e errFile

エラーのためにTimesTen表にコピーできない行に関する情報を、ttBulkCpが記録するファイルの名前を示します。このようなエラーには、解析エラー、型変換エラーおよび制約違反が含まれます。errFileのデフォルト値はstderrです。エラー・ファイルの書式は入力ファイルの書式(「データファイルの書式」を参照)と同じであるため、エラー・ファイルのエラーを修正して、その後のttBulkCpの実行時に、修正したエラー・ファイルを入力ファイルとして使用することもできます。

-F firstRow

コピーする最初の行の番号を示します。TimesTen表に行のサブセットをコピーするには、このオプションを(任意で-Lとともに)使用します。行には、1から始まる番号が付けられます。複数の入力ファイルを指定した場合、行には、すべてのファイルをとおした連続番号が付けられます。デフォルト値は1です。

-L lastRow

コピーする最後の行の番号を示します。-Fの説明を参照してください。0の値は最後の入力ファイルの最後の行を指定します。デフォルト値は0です。

-m maxErrors

レポートするエラーの最大数を指定します。
デフォルトは1です。

0 (ゼロ)に設定した場合、ttBulkCpによってすべてのエラー・メッセージが返されます。最大制限はありません。

-S error
-S warn

-S ignore

デフォルトでは、ttBulkCpによってその最大スケールを超える値が検出されると、エラーが発行されます。このエラーは、スケールがその列の最大スケールを超える10進値、または小数秒が6桁を超える(サブマイクロ秒の粒度)のTIMESTAMP値に対して発行されます。
-S error(デフォルト): ttBulkCpがその最大スケールを超える値を含む行を表に挿入せず、エラーをエラー・ファイルに記録することを指定します。

-S warn: ttBulkCpが行を表に挿入する前に、その最大スケールまで値の右側を切り捨て、警告をエラー・ファイルに記録することを指定します。

-S ignore: ttBulkCpが行を表に挿入する前に、その最大スケールまで値の右側を暗黙的に切り捨てることを指定します。

-t error
-t warn

-t ignore

デフォルトでは、CHAR、VARCHAR2、NCHAR、NVARCHAR2、BINARY、VARBINARY、BLOB、CLOBまたはNLOBの値がその最大列幅を超えている場合、ttBulkCpによってエラーが発行されます。
-t error(デフォルト): 長い文字列やbinary属性を含む行はTimesTen表に挿入されず、エラーがエラー・ファイルに記録されることを指定します。

-t warn: 長い文字列やbinary属性は表に挿入される前に最大列長に切り捨てられるが、警告がエラー・ファイルに記録されることを指定します。

-t ignore: 長い文字列やbinary属性は、表に挿入される前に最大列長に暗黙的に切り捨てられることを指定します。

-[no]tblLock

TimesTen表に行をコピーする際に、表レベル・ロックを使用するか行レベル・ロックを使用するかを指定します。
-tblLock:表レベル・ロックを示します。これはデフォルトです。

-notblLock:行レベル・ロックを示します。

表への単一の入力ストリームの場合、-tblLockの使用が最も効率的です。複数の同時ttBulkCpセッションを使用して単一の表に並行して挿入する場合には、-notblLockを使用するとパフォーマンス面で利点があります。

-u error
-u warn

-u ignore

デフォルトでは、real、floatまたはdouble属性のアンダーフロー時に、ttBulkCpはエラーを発行します。アンダーフローは、浮動小数点数が非常に小さく、0(ゼロ)に切り捨てられる場合に発生します。
-u error(デフォルト): アンダーフローしたreal、floatまたはdouble値を含む行はTimesTen表に挿入されず、エラーがエラー・ファイルに記録されることを指定します。

-u warn: アンダーフローしたreal、floatまたはdouble属性に0.0が挿入されるが、警告がエラー・ファイルに記録されることを指定します。

-u ignore: アンダーフローしたreal、floatまたはdouble属性に、暗黙的に0.0が挿入されることを指定します。

-xp numRows
-xp rollback

ロードのトランザクション・ポリシーを設定します。0の値は、ttBulkCpがロード全体を単一のトランザクションとして実行し、ロードの成功、失敗にかかわらず、そのトランザクションをコミットすることを示します。
rollbackの値は、ttBulkCpがロード全体を単一のトランザクションとして実行し、ロードが失敗した場合には、そのトランザクションをロールバックすることを示します。

0(ゼロ)以外の値は、行がnumRows処理されるたびにttBulkCpがコミットすることを示します。

デフォルト値は1024です。

データベースの定期的なチェックポイントを有効にするには、-xpオプションを-cpオプションとともに使用します。

データファイルの書式

この項では、dataFileパラメータの書式について説明します。

ttBulkCp入力ファイルの各行は、空白行、コメント行、属性行またはデータ行のいずれかです。

- 空白行とは、空白文字(スペースとタブ)を含む、文字がまったくない行のことです。空白行はttBulkCpによって無視されます。

- コメント行はコメント文字で始まります。デフォルトのコメント文字は#で、このデフォルトは、-Cコマンドライン・オプションまたはCOMMENTCHARファイル属性(「属性行の書式」を参照)で上書きできます。コメント文字は行の先頭文字である必要があります。コメント行はttBulkCpによって無視されます。データ行の最後にあるコメントは、サポートされません。

- ファイル属性行は、データファイルの書式を制御するファイル属性の設定に使用されます。属性行は10文字からなる文字列##ttBulkCpで始まります。属性行の完全な構文については、項「ファイル属性行の書式」を参照してください。属性行は、データファイルの任意の場所に記述できます。

- データ行には、コピー元の表の行が含まれます。データファイルのデータ行と表の行は1対1で対応します(つまり各データ行は、1つの行を完全に記述します)。各データ行は、フィールド・セパレータ文字によって区切られた列値のリストで構成されます。デフォルトのフィールド・セパレータはカンマ(,)です。このデフォルトは、-sコマンドライン・オプションまたはFSEPファイル属性によって上書きできます。データ行の完全な構文については、項「データ行の書式」を参照してください。

ファイル属性行の書式

属性行の書式は次のとおりです。

##ttBulkCp[:attribute=value]...

属性行は、コメント文字が#でない場合であっても、10文字からなる文字列##ttBulkCpで始まります。この文字列の後には、それぞれのファイル属性設定の前にコロンを付けて、0(ゼロ)または1つ以上の属性を指定できます。

ファイル属性設定が有効なのは、入力ファイルの終わりまで、または同じ入力ファイルで他の属性行によって変更されるまでです。属性行で省略されたファイル属性の値はそのままで変更されません。

ほとんどのコマンドライン・オプションは、ttBulkCpでサポートされるファイル属性の値よりも優先されます。CHARACTERSET属性は、コマンド・ライン・オプションを上書きできる唯一の属性です。

次のファイル属性があります。

- CHARACTERSET: データファイルを解釈するために使用されるキャラクタ・セットを指定します。ファイル属性が設定されていない場合は、ConnectionCharacterSet接続属性で指定したキャラクタ・セットがファイルの解釈に使用されます。最適なパフォーマンスを得るためには、DatabaseCharacterSet接続属性の値を、ConnectionCharacterSet接続属性またはこのファイル属性のいずれかと一致させます。ConnectionCharacterSet接続属性またはこのファイル属性で、ファイルの実際のキャラクタ・セットとは異なるキャラクタ・セットを指定すると、ttBulkCpはデータを正しく解釈できない場合があります。

- VERSION: ファイルで使用されるファイル形式のバージョンを指定します(major.minorとして表されます)。サポートされるバージョンは1.0のみです。

- DATEMODE: Oracle DatabaseのDATE型が単純な日付として扱われるか、タイムスタンプとして扱われるかを指定します。

- FSEP: ファイルで使用されるフィールド・セパレータ文字を指定します。フィールド・セパレータは、\t (タブ)、または~ ! @ # $ % ^ & * ( ) = : ; | < > ? , /のいずれかの文字に設定できます。

- QUOTES: ファイル内の文字列値が二重引用符で囲まれるかどうかを示します。0の値は文字列が引用符で囲まれないことを示し、1の値は文字列が引用符で囲まれることを示します。この値は-Qオプションで上書きされます。

- COMMENTCHAR: ファイルで使用されるコメント文字を指定します。コメント文字は、\t (タブ)、または~ ! @ # $ % ^ & * ( ) = : ; | < > ? , /のいずれかの文字に設定できます。

コメント文字は、データファイルでのコメントの使用を無効にする、値noneに設定することもできます。

- DFORMAT: 日付書式を設定します。指定できる値の一覧は、「日付、時刻およびタイムスタンプの値」を参照してください。ユーザー定義の書式が使用されている場合は、一重引用符で囲む必要があります。この値は-D/-dformatコマンドライン・オプションで上書きされます。関連項目: TFORMATおよびTSFORMAT。

- NCHARENCODING: NCHARとNVARCHAR2データ型に使用するエンコードを示します。値はASCIIまたはUTF-8です。

- TFORMAT: 時刻書式を設定します。指定できる値の一覧は、「日付、時刻およびタイムスタンプの値」を参照してください。ユーザー定義の書式が使用されている場合は、一重引用符で囲む必要があります。この値は-tformatコマンドライン・オプションで上書きされます。関連項目: DFORMATおよびTSFORMAT。

- TSFORMAT: タイムスタンプ書式を設定します。指定できる値の一覧は、「日付、時刻およびタイムスタンプの値」を参照してください。ユーザー定義の書式が使用されている場合は、一重引用符で囲む必要があります。この値は-tsformatコマンドライン・オプションで上書きされます。関連項目: DFORMATおよびTFORMAT。

例

次のヘッダー行はフィールド・セパレータ文字を$ に設定し、文字列を引用符で囲むことを無効にします。

##ttBulkCp:FSEP=$:QUOTES=0

次のヘッダー行はコメントを無効にし、日付書式をOracle書式に設定します。

##ttBulkCp:COMMENTCHAR=none:DFORMAT=Oracle

次のヘッダー行は、日付書式をカスタム書式に設定します。

##ttBulkCp:DFORMAT='Mon DD, YYYY'

データ行の書式

データ行には、コピー元の表の行データが含まれます。各データ行は表の行に対応します(行は複数の入力ファイル行にまたがることはできません)。データ行は、フィールド・セパレータ文字によって区切られる、列値のリストで構成されます。フィールド・セパレータの前後に、不要な空白文字を置くことはできません。それぞれの値の書式はその型によって決定されます。

NULL値

NULL値は、NULL(すべて大文字、引用符なし)、または空のフィールドとして表すことができます。

文字とUnicode文字列

CHAR、VARCHAR2、NCHAR、NVARCHAR2、CLOB、NCLOB: 文字列を引用符で囲むことが有効になっている場合(デフォルト)、文字列および文字は二重引用符で囲む必要があります。文字列を引用符で囲むことが無効になっている場合、文字列の中の二重引用符文字はどれも文字列自体の一部であるとみなされ、文字列を引用符で囲むことが有効になっているかどうかにかかわらず、ttBulkCpでは文字列の中の次のバックスラッシュ・エスケープ文字が認識されます。

- \": 二重引用符文字。文字列を引用符で囲むことが有効になっている場合、文字列のすべての二重引用符文字はバックスラッシュでエスケープされる必要があります。文字列を引用符で囲むことが無効になっている場合、バックスラッシュの使用は許容されますが、必要ではありません。

- \t: タブ文字。

- \n: 改行文字。

- \r: 改行文字。

- \\: バックスラッシュ文字。

- \xyz(CHARとVARCHAR2のみ): ASCII値がxyzである文字、xyzは、\033のような3文字の8進数です。

- \uxyzw(NCHARとNVARCHAR2のみ): Unicode値がxyzwである文字、xyzwは、\ufe4aのような4桁の16進数です。\uxyzw表記法はUTF-8とASCIIの両方のエンコード・モードでサポートされます。

また、~ ! @ # $ % ^ & * ( ) = : ; | < > ? , /文字のいずれもバックスラッシュでエスケープすることができます。多くの場合、これらの文字をエスケープする必要はありませんが、エスケープすると、文字列を引用符で囲むことが無効になっていても、コメント文字やフィールド・セパレータと解釈されるのを回避できます。

引用符で文字列を囲むことが有効になっている場合、空の文字列(" "として表される)はNULLと区別されます。引用符で文字列を囲むことが無効になっている場合、NULLと区別できないため、空の文字列を表すことはできません。

Unicode文字列の場合、UTF-8マルチバイト・シーケンスを使用してエンコードされるUnicode文字は、UTF-8エンコード・モードのみでサポートされます。これらのシーケンスがASCIIエンコード・モードで使用された場合、ttBulkCpはシーケンス内の各バイトを別々の文字として解釈します。

固定長のCHARとNCHARフィールドの場合、フィールド長よりも短い文字列は空白で埋められます。VARCHAR2およびNVARCHAR2フィールドの場合、文字列はデータファイルに指定されているとおり正確にTimesTenに入力されます。後続の空白は追加も削除されません。

バイナリ値

BINARY、VARBINARY, BLOB: 文字列を引用符で囲むことが有効になっている場合(デフォルト)、バイナリ値は中括弧({...})によって区切られます。文字列を引用符で囲むことが無効になっている場合、中括弧は使用されません。文字列を引用符で囲むことが有効か無効かにかかわらず、バイナリ値はオプションの0xまたは0Xで始めることができます。

バイナリ・データの各バイトは、2つの16進数として表されます。たとえば、次のような4バイトのバイナリ文字列があるとします。

01101000 11001010 01001001 11101111

このバイナリ文字列は、次の8文字の16進文字列として表されます。

68CA49EF

AからFの文字によって表される数字は、大文字でも小文字でもかまいません。16進文字列は空白を含むことができません。16進文字列の文字の各対が単一のバイナリ・バイトに変換されるため、16進文字列には偶数個の文字が含まれている必要があります。固定長バイナリ・フィールドでは、指定された値が列長よりも短い場合、値の右側に0(ゼロ)が埋め込まれます。VARBINARY値の場合、バイナリ値はデータファイルに指定されているとおり正確にTimesTenに挿入されます。

文字列を引用符で囲むことが有効になっている場合、長さが0(ゼロ)のバイナリ値({ }として表される)はNULLと区別されます。文字列を引用符で囲むことが無効になっている場合、NULLと区別できないため、長さが0(ゼロ)のバイナリ値を表すことはできません。

整数値

TINYINT、SMALLINT、INTEGER、BIGINT: 整数値は、オプションの符号とその後に続く1つ以上の数字で構成されます。整数値では、E表記法は使用できません。次に例を示します。

-14 98765 +186

浮動小数点値

REAL、FLOAT、DOUBLE: 浮動小数点値は小数点の有無にかかわらず表すことができ、E表記法を使用することもできます。次に例を示します。

3.1415
-0.00004
1.1e-3
5e3
.56
-682
-.62E-4
170.

固定小数点値

DECIMAL、NUMERIC: 10進値は小数点の有無にかかわらず表すことができます。10進値ではE表記法を使用できません。次に例を示します。

5
-19.5
-11
000
-.1234
45.
-57.0
0.8888

Inf、-InfおよびNaN値

Inf、-InfおよびNan値: 無限大および数字以外の値は、文字列で表現して対応する定数値を表すことができます(すべて大/小文字は区別されません)。

文字列

値

NAN

NaN

[+]INF

Inf

-INF

-Inf

TimesTenでは、値がNAN、INFおよび-Infとして出力されます。

日付、時刻およびタイムスタンプの値

日付、時刻およびタイムスタンプの値は、固定日時書式を選択するか、カスタムの日時書式を定義することによって指定できます。カスタムの日時書式は、TO_DATEおよびTO_CHAR SQL関数で使用されるものに類似した書式指定子を使用して定義されます。

デフォルトのTimesTenの書式(DF*TF+FF)は日付および時刻書式に関して定義されているため、多くの場合、カスタムの日付または時刻書式が使用されている場合にもタイムスタンプ書式を定義する必要はありません。このため、日付書式を設定すると、日付値の書式のみでなく、タイムスタンプ値の日付部分も設定されます。同様に、タイムスタンプ書式を設定すると、時刻値とタイムスタンプ値の時刻部分の両方が影響を受けます。

指定子

説明および制限

Q

四半期。コピーイン・モードでは使用できません。

YYYY

年(4桁)。

Y,YYY

年(カンマ付き)。

YYY

年(末尾3桁)。コピーイン・モードでは使用できません。

Y

年(末尾1桁)。コピーイン・モードでは使用できません。

MONTH

月(空白が埋め込まれた9文字の正式名、大/小文字の区別なし)。

MON

月(3文字の接頭辞、大/小文字の区別なし)。

MM

月(01から12)。

DD

日付(01から31)。

HH24

時刻(00から23)。

HH12

時刻(01から12)。コピーイン・モードでは、AM/PMを指定する必要があります。

HH

時刻(01から12)。コピーイン・モードでは、AM/PMを指定する必要があります。

MI

分(00から59)。

SS

秒(00から59)。

FF

小数秒。6桁(-tsprecオプションで上書きされる場合を除く)。

FFn

小数秒(nで指定される桁数)。

+FF

コピーイン・モードでは、オプションの小数点に加えて、1つ以上の小数秒と一致します。コピーアウト・モードでは、.FFと同じです。

+FFn

コピーイン・モードでは、+FFと同じです。コピーアウト・モードでは、.FFnと同じです。

AM PM

ドットなしの正午標識。コピーイン・モードでは、これはHH24ではなく、HHまたはHH12とともに使用する必要があります。

A.M.
P.M.

ドット付きの正午標識。コピーイン・モードでは、これはHH24ではなく、HHまたはHH12とともに使用する必要があります。

DF

現在の日付書式(タイムスタンプ書式でのみ使用できます)。

TF

現在の時刻書式(タイムスタンプ書式でのみ使用できます)。

- / ; :

コピーイン・モードで一致するか、コピーアウト・モードで出力される記号。

"text"

入力モードで一致するか、コピーアウト・モードで出力されるテキスト。

*

コピーイン・モードで0個以上の空白文字(スペースまたはタブ)と一致するか、コピーアウト・モードで1つの空白を出力します。

固定の日付、時刻およびタイムスタンプ書式

日付値の場合、固定書式は次のとおりです。

書式

説明

ODBC

YYYY-MM-DD
例: 2011-01-03

(デフォルト値)

Oracle

DD-Mon-YYYY
例: 03-Jan-2011

SYBASE1

MM/DD/YYYY
例: 01/03/2011

SYBASE2

DD-MM-YYYY
例: 03-01-2011

SYBASE3

Mon*DD*YYYY
例: Jan 03 2011

時刻値の場合、固定書式はODBCのみです。

書式

説明

ODBC

HH24:MI:SS
例: 07:47:23

タイムスタンプ値の場合、固定書式は次のとおりです。

書式

説明

ODBC

YYYY-MM-DD*HH24:MI:SS+FF
例: 2011-01-03 07:47:23

Oracle

DD-Mon-YYYY*HH24:MI:SS+FF
例: 03-Jan-2011 07:47:23

SYBASE1

MM/DD/YYYY*HH24:MI:SS+FF
例: 01/03/2011 07:47:23

SYBASE2

DD-MM-YYYY*HH24:MI:SS+FF
例: 03-01-2011 07:47:23

SYBASE3

Mon*DD*YYYY*HH24:MI:SS+FF
例: Jan 03 2011 07:47:23

デフォルトのタイムスタンプ値は、「DF*TF+FF」です。

例

次の入力ファイルは、5つの列(2つのCHAR列と、double列、integer列およびVARBINARY列を1つずつ)を持つ表のためのものです。Mountain View行には、最後の3つの列にNULL値が存在します。

##ttBulkCp
# This is a comment.
###### So is this.
# The following line is a blank line.

"New York","New York",-345.09,12,{12EF87A4E5}
"Milan","Italy",0,0,{0x458F}
"Paris","France",1.4E12,NULL,{F009}
"Tokyo","Japan",-4.5E-18,26,{0x00}
"Mountain View","California",,,

上記の入力ファイルと同等の入力ファイルを次に示します。このファイルでは、引用符が無効、コメント文字が「$」、フィールド・セパレータが「|」です。

##ttBulkCp:QUOTES=0:COMMENTCHAR=$:FSEP=|
$ This is a comment.
$$$$$$ So is this.
$ The following line is a blank line.

New York|New York|-345.09|12|12EF87A4E5
Milan|Italy|0|0|0x458F
Paris|France|1.4E12|NULL|F009
Tokyo|Japan|-4.5E-18|26|0x00
Mountain View|California|||

次のコマンドは、表mytblの内容をデータベースmystoreからファイルmytbl.dumpにダンプします。

ttBulkCp -o mystore mytbl mytbl.dump

次のコマンドは、mytbl.dumpファイルにリストされている行を、データベースmystoreのmytblという表にロードします。エラー・メッセージは、mytbl.errファイルに格納されます。

ttBulkCp -i -e mytbl.err mystore mytbl mytbl.dump

前述のコマンドは、最初のエラーの発生後に終了します。入力ファイルの終わりまで(または、リカバリ不能なエラーが発生するまで)コピーを続行させるには、次のように-m 0を使用します。

ttBulkCp -i -e mytbl.err -m 0 mystore mytbl mytbl.dump

制約違反によって発生するエラーを無視するには、つぎのように-d ignoreを使用します。

ttBulkCp -i -e mytbl.err -d ignore mystore mytbl mytbl.dump

注意

データベースの不慮の破損を防ぐため、ttBulkCpではOverwrite接続属性は明示的に0に設定されます。詳細は、「Overwrite」を参照してください。

浮動小数点数が小さい場合、real、floatまたはdoubleの値は0(ゼロ)に切り捨てられる場合があります。

このユーティリティでは、0以外の値を指定したPassThrough接続属性はサポートされていないため、0以外の値を指定するとエラーが返されます。

日付、時刻およびタイムスタンプの書式を設定する場合、入力モードでは不完全または冗長な書式は使用できません。データ型に存在しないフィールド(日付書式の分の指定子など)を参照すると、コピーアウト・モードではエラーを返します。コピーイン・モードでは、それらの指定子の値は無視されます。

ttBulkCpデータファイル内の引用符で囲まれた文字列を無効にする場合は、次の注意事項が適用されます。

- NULLと区別できないため、空の文字列と長さが0(ゼロ)のバイナリ値は表すことができません。

- フィールド・セパレータ文字が文字列にある場合は、バックスラッシュでエスケープさせる必要があります。そうしないと、実際のフィールド・セパレータとして扱われます。

- データ行が文字列で始まり、その文字列がコメント文字で始まる場合、その文字をバックスラッシュでエスケープさせないと、その行はコメントとして扱われます。ファイル内に実際のコメントがない場合、コメント文字をnoneに設定して文字がコメント文字として誤読されないようにします。

UTF-8の場合、NCHARはUTF-8エンコードに変換されてから出力されます。UTF-8入力はNCHARに変換されます。

ASCIIの場合、ASCII文字に対応するNCHAR値はASCIIとして出力されます。ASCII以外のNCHAR値では、エスケープされたUnicode書式が使用されます。

Windowsでは、すべてのTimesTen Data ManagerおよびクライアントDSNで、このユーティリティがサポートされています。

アプリケーションのロックの競合問題を回避するために、ttBulkCp実行中はDDL SQLを実行しないことをお薦めします。

関連項目

ttBackup
ttMigrate
ttRestore

ttCacheAdvisor

説明

パフォーマンスを最適化し、ストレージ・オーバーヘッドを最小にするために、TimesTen Cacheの構成を助けます。このユーティリティは、取得されたSQLワークロード(ターゲットOracle Databaseまたは既存のSQLチューニング・セット上で実行中)を評価します。また、ターゲット・データベースのスキーマ定義も評価します。

このユーティリティは表および列の使用パターンを分析し、レポートと実装スクリプトを生成することにより、ワークロードのパフォーマンスを改善するためのTimesTenキャッシュ・グループ定義を推奨します。さらにオプションで、推奨されたキャッシュのパフォーマンスを評価し、それをターゲットOracle Databaseのパフォーマンスと比較します。

必要な権限

このユーティリティには、インスタンス管理者の権限が必要です。

構文

一般分析

ttCacheAdvisor
-oraTarget
{-oraConn Oracle_connection_string} ...
-oraDirObject Oracle_directory_object
[{-oraDirNfs path} | {-ftp network_connection_string}]
-oraRepository
-oraConn Oracle_connection_string
-oraDirObject Oracle_directory_object
[{-oraDirNfs path} | {-ftp network_connection_string}]
-ttConn TimesTen_connection_string
[-captureCursorCache minutes] [-flushSharedPool] [-plsqlInfo]
[-cacheSize {{size{MB|GB|TB}} | UNLIMITED}]
[-writethruThreshold percent%]
[-report path]
[-evalSqlPerf [maximum[%]]]
[-task task_name]
[-description string]
[-rerun]
[-showSql]
[-trace [traceName]]
[{-import [-noSchema] path} ...]
[-add
{-tableAttrib [owner.]table_name
{-pk '(column_name, ...)' |
-fk '(column_name, ...) REFERENCES (primary_key_column_name, ...)
[ON DELETE CASCADE]' |
-where '(predicate)'} ...
} ...]
[-drop
{-tableAttrib [owner.]table_name
{-pk | -fk | -where} ...
} ...]
[{{-add | -drop} -sqlSet [owner.]sql_set_name}]
[{-command | @} path]

-oraTargetの各オプションを繰り返して同じターゲットOracle Databaseに対して複数のユーザーを指定すれば、複数のスキーマのオブジェクトを分析できます。1回のCache Advisorの評価実行では1つのOracleリポジトリのみ指定できます。

オプションで、文字列値は一重引用符または二重引用符で囲むことができます。文字列がダッシュ(-)で始まる場合、その文字列は一重引用符または二重引用符で囲む必要があります。

使用方法のメッセージを出力して終了します。

ttCacheAdvisor {{-help | -h} [option]}

ttCacheAdvisorのリリース番号を出力し、終了します。

ttCacheAdvisor {-V | -version}

ワークロードおよびスキーマ定義をターゲットOracle Databaseからファイルにエクスポートします。

ttCacheAdvisor
[{-command|@} path]
{-oraTarget
-oraConn oracle_connection_string
-oraDirObject oracle_directory_object
[{-oraDirNfs| -ftp} network_connection_string]
} ...
-captureCursorCache minutes [-flushSharedPool]
-export [-zip] path
[-showSql]

リポジトリOracle Databaseにある既存のタスクの要約または詳細を表示します。

ttCacheAdvisor  [{-command|@} path]
-oraRepository -oraConn oracle_connection_string
-showTask [task_name]
[-showSql]

既存のタスクをリポジトリOracle Databaseから削除します。

ttCacheAdvisor
[{-command|@} path]
-oraRepository -oraConn oracle_connection_string
-dropTask task_name
[-showSql]

ターゲットOracle Databaseで実行されているSQLワークロードを取得して分析するためのCache Advisorの使用の詳細は、『Oracle TimesTen Application-Tier Database Cacheユーザーズ・ガイド』を参照してください。

オプション

ttCacheAdvisorには次のオプションがあります。

オプション

説明

{-add | -drop}

-addは、指定したアイテムをttCacheAdvisorタスクに追加します。
-dropは、指定したアイテムをttCacheAdvisorタスクから削除します。-dropは-rerunオプションでのみサポートされます。

これらのオプションを使用してキャッシュ・グループとキャッシュ表属性、およびワークロードオプションを追加したり削除したりします。

-cacheSize {{size{MB|GB|TB}} | UNLIMITED}

TimesTen データベースの最大サイズを、メガバイト(MB)、ギガバイト(GB)またはテラバイト(TB)で指定します。デフォルトはUNLIMITEDです。.
この値は、TimesTen Cacheをデプロイする予定のシステムで使用可能な永続メモリーの量に設定する必要があります。

-captureCursorCache minutes

ttCacheAdvisorが、Oracleターゲット・データベースのOracleカーソル・キャッシュからSQLワークロードを取得するように指定します。この取得操作は一連のスナップショットとして発生し、指定した分数間持続します。分の端数は、minutesの少数点値を使用して指定できます。.
Oracleターゲット・データベースは、内部経験則に基づいて、特定のSQL文に対するカーソルをアンロードすることによってカーソル・キャッシュを管理します。そのため、指定されたカーソル・キャッシュ・スナップショットが取得されたときに、どのSQL文に対してどのカーソルがOracleカーソル・キャッシュに入れられるのかを正確に予測することはできません。Oracleでは、一部のSQL文が取得されないことを防ぐために、少なくとも10分の取得期間を推奨しています。ただし、特定のアプリケーション・ワークロード動作や小さいOracleカーソル・キャッシュでは、SQL文が取得されない事態を防ぐため、それよりも長い取得期間が必要な場合もあります。

{-command|@} path

ttCacheAdvisorコマンドのファイルを指定します。このオプションは、オプションが許可されているコマンド行のどこにでも使用できます。コマンド・ファイルは再帰的にならなければ、任意の深さにネストできます。空白行および#コメント区切り文字で始まる行は、ファイルで無視されます。

-description string

ttCacheAdvisorタスクの説明を指定します。説明は最大で4000バイト長です。

-dropTask task_name

指定したタスクを削除します(そのタスクのために作成またはコピーされ、他のいずれのタスクにも使用されていないSQLチューニング・セットを含む)。

-evalSqlPerf [max[%]]

ttCacheAdvisorがTimesTenデータベースのSQLワークロード文のパフォーマンスをターゲットOracle Databaseと比較することを指定します。-evalSqlPerfオプションはテスト・ターゲット・データベースでのみ使用し、本番ターゲット・データベースでは使用しないでください。
評価するSQL文の数またはパーセントを指定できます。パーセントの場合は%文字を含めてください。デフォルトは100%です。

評価するSQL文の数を制限する場合は、ttCacheAdvisorは取得したワークロードおよびターゲット・スキーマ統計に基づき、キャッシングの可能性が最も高く思われるSQL文を評価します。

-evalSqlPerfオプションを使用する場合、クライアントDSNではなく、-ttConnオプションとの直接接続DSNを指定する必要があります。

-export [-zip] path

-captureCursorCacheオプションで指定したワークロードをttCacheAdvisorがエクスポートすることを指定します。
-exportオプションは-oraRepositoryオプション、-ttConnオプション、-reportオプションまたは-taskオプションとともに使用することはできません。

-zipオプションはエクスポートしたワークロードを1つのzipファイルに圧縮します。-zipオプションを使用する場合はzipユーティリティがTimesTenシステムにインストールされ、実行可能パスに置かれていることが必要です。pathには、エクスポート・ファイルのTimesTenシステム上の場所を指定します。

-zipオプションを指定した場合、ttCacheAdvisorは.zipファイル拡張子の付いた1つの圧縮ファイル(ファイル名はpathの最後の文字列)を作成します。-zipオプションを指定しない場合、ttCacheAdvisorはエクスポート・ファイルをpathディレクトリに書き込みます。-exportオプションにより作成されたすべてのファイルの名前の接頭辞は、pathの最後の文字列です。

-fk '(column_name, ...) REFERENCES (primary_key_column_name, ...) [ON DELETE CASCADE]'

表の外部キーを指定します。指定した外部キーがOracle Database内の既存の外部キーのサイクルを作成する場合、ttCacheAdvisorは既存の外部キーを使用せず、指定した外部キーを使用します。
-fkオプションを-addオプションとともに使用する場合、'(column_name, ...) REFERENCES (primary_key_column_name, ...) [ON DELETE CASCADE]'は必須で、-dropオプションとともに使用する場合は任意指定です。

-flushSharedPool

ワークロードの取得前にターゲットOracle Databaseの共有プールをフラッシュします。-captureCursorCacheオプションを指定した場合にのみ指定できます。
-flushSharedPoolオプションは、分析中のアプリケーションに関連付けられていないカーソル・キャッシュ内にSQL文を含む可能性のあるターゲット・データベースでのみ使用します。-flushSharedPoolオプションは、本番ターゲット・データベースでは使用しないでください。

{-help | -h} [option]

使用方法のメッセージを出力して終了します。

-import [-noSchema] path

以前にエクスポートされたワークロードおよびスキーマをttCacheAdvisorがインポートすることを指定します。
-importオプションは-captureCursorCacheオプションや-flushSharedPoolオプションとともに使用することはできません。

スキーマなしでワークロードをインポートするには、-noSchemaを使用します。このオプションは、対象のスキーマがすでにOracleリポジトリ・データベースで定義されている場合に便利です。

pathにはエクスポートされるワークロードおよびスキーマのTimesTenシステム上の場所を指定します。-importオプションは最初にエクスポート・ファイルが含まれているpathという名前のディレクトリを検索し、次にpath.zipという名前のファイルを検索します。

以前にエクスポートされた複数のスキーマやワークロードをインポートするために、-importオプションを同じttCacheAdvisor実行に対して複数回指定できます。

ワークロードおよびスキーマを-zipオプションを使用してエクスポートした場合は、unzipユーティリティをTimesTenシステムにインストールし、実行可能パスに置く必要があります。

-oraConnOracle_connection_string

Oracle Databaseユーザーとオプションのパスワード、Oracle Netサービス名および任意のオプション接続属性を指定します。Oracle接続文字列の標準書式は次のとおりです。
Oracle_user[/password]@Oracle_net_service_name

Oracle Database接続文字列からパスワードが省略された場合、パスワードを求めるプロンプトがttCacheAdvisorにより表示されます。

アスタリスク(*)がパスワードとして指定された場合、ttCacheAdvisorはOracle Databaseに対して自動許可が構成されているとみなし、パスワードを求めるプロンプトは表示されません。

指定できるリポジトリOracle Databaseへの接続は最大1つです。

Oracleターゲット・データベースへの複数の接続を指定して、複数のターゲット・スキーマのスキーマ定義を分析し、もともとは別のOracleターゲット・データベース・ユーザーにより実行されたSQL文のパフォーマンス評価を行うことができます。Oracleターゲット・データベースへ複数の接続を指定するには、別のターゲットOracle Databaseユーザーおよび同じターゲットOracleネット・サービス名を使用して、-oraTargetオプションの後に-oraConnオプションを複数回指定します。

-captureCursorCacheが指定されている場合、ttCacheAdvisorではワークロードを取得するために指定した最初の-oraTarget -oraConn接続を使用します。

-oraRepository

ttCacheAdvisorがアプリケーション・ワークロードおよびスキーマ定義の分析を実行するのに使用されるリポジトリOracle Database (バージョン11.2.0.2以上)を指定します。
-oraRepositoryまたは-oraTargetのいずれも指定されていない場合は、同じOracle Databaseがリポジトリとしてもターゲットとしても使用されます。

-oraTarget

TimesTenデータベースでキャッシュするターゲットOracle Database (バージョン10.2.0.4以上)を指定します。
-oraTargetまたは-oraRepositoryのいずれも指定されていない場合は、同じOracle Databaseがターゲットとしてもリポジトリとしても使用されます。

-pk '(column_name, ...)'

表の主キーを指定します。これは、Oracle Database表のすべての主キーよりも優先されます。
-pkオプションを-addオプションとともに使用する場合、'(column_name, ...)'は必須で、-dropオプションとともに使用する場合は任意指定です。

-plsqlInfo

SQL文が発生したPL/SQLオブジェクトに関する情報を持つ、取得済ワークロードを増分します。-captureCursorCacheオプションを指定した場合にのみ指定できます。
このワークロード増分処理は、ターゲット・データベースの負荷を増加させる可能性があります。

-report path

ttCacheAdvisorによってリコメンデーション・レポートおよび実装スクリプトが書き込まれるTimesTenシステムのディレクトリを指定します。デフォルトは、ttCacheAdvisorが起動されたtask_nameディレクトリです。
ttCacheAdvisorユーティリティは、レポートを構成するファイルをディレクトリに書き込む前にそのディレクトリを作成するため、指定したディレクトリは存在することができません。

-rerun

ttCacheAdvisorが現在のタスクを再実行することを指定します。-rerunオプションは、-task task_nameオプションとともに使用する必要があります。

-showSql

ttCacheAdvisorが、TimesTenデータベース、ターゲットOracle DatabaseおよびリポジトリOracle Databaseで実行するSQL文を表示することを指定します。文を表示した後でttCacheAdvisorは続行するかどうかを問うプロンプトを表示します。
このオプションを使用して、影響が発生する前にttCacheAdvisorの影響を評価します。

-showTask [task_name]

指定したタスクまたはすべてのタスクに関する情報を表示します。task_nameが指定されていない場合、リポジトリOracle Databaseに保管されているすべてのタスクについて要約情報が表示されます。task_nameが指定されていない場合、指定したタスクについての詳細情報が表示されます。

-sqlSet [owner.]sql_set_name

SQLチューニング・セットをttCacheAdvisorタスクに追加、または削除することを指定します。-addが指定された場合、ttCacheAdvisorは、指定されたSQLチューニング・セットを最初にリポジトリOracle Databaseで検索し、次にターゲットOracle Databaseで検索します。-dropが指定された場合、ttCacheAdvisorはタスクからSQLチューニング・セットを削除します。タスクのためにSQLチューニング・セットが作成またはコピーされた場合も、ttCacheAdvisorはリポジトリ・データベースからSQLチューニング・セットを永続的に削除します。
コマンドラインでは複数のSQLセットを追加または削除できます。次に例を示します。

-add -sqlSet ADVISOR.TEST1
-add -sqlSet ADVISOR.TEST2

-tableAttrib [owner.]table_name

ttCacheAdvisorがキャッシュのリコメンデーションに使用するキャッシュ・グループおよびキャッシュ表属性を指定します。スキーマおよび表の名前にはワイルドカード文字(%)を含めることができます。属性を削除する場合、スキーマおよび表の名前はそれらが追加されたときに指定された名前と一致する必要があります(ワイルドカード文字がある場合はそれを含む)。
スキーマまたは表の名前にワイルドカード文字を使用することにより、属性を複数の表に適用するように指定できます。ttCacheAdvisorは個々の表に対して最初に指定された値を使用します。

-task task_name

タスク名を指定します。名前は最大30バイト長が可能で、リポジトリOracle Databaseに保管されているttCacheAdvisorタスクで固有である必要があります。言い換えれば、task_nameという名前のタスクは、ttCacheAdvisorユーティリティの実行時に存在することはできません。それ以外の場合、タスクは-dropTaskオプションを使用して最初に削除する必要があります。
タスクとは、ワークロード、パフォーマンス結果、およびユーザーが指定するttCacheAdvisorオプションに関する情報が含まれているオブジェクトです。

タスク名を使用してタスクを実行、再実行、表示、または削除します。デフォルトのタスク名はuser-name_host-name_timestampで、必要があれば切り捨てられて30バイトになります。

-trace [traceName]

Oracle TimesTenカスタマ・サポートに提供できる、デバッグ・トレース情報を取得します。
デフォルトでは、すべてのトレース・ファイルが次のディレクトリに置かれています。

install_dir/info/advisor/traceyyyymmddhhmmss

-trace traceNameオプションでトレース名を指定すると、トレース・ファイルは次のディレクトリに置かれます。

install_dir/info/traceName/traceyyyymmddhhmmss

yyyymmddhhmmssは、Cache ttCacheAdvisorが起動したときに設定されたタイムスタンプで、4桁の年、2桁の月、2桁の日にち、2桁の時間、2桁の分、2桁の秒が含まれます。

PATH環境変数で設定されたディレクトリのいずれかにzip実行可能ファイルがある場合、それらのトレース・ファイルはパス内で最初に遭遇したzip実行可能ファイルを使用して、ttca_debug_log.zipという名前の1つの圧縮ファイルに自動的に圧縮されます。(他の圧縮ユーティリティは認識されず、使用されません。)

-ttConn TimesTen_connection_string

ttCacheAdvisorがキャッシュの検証と評価に使用するTimesTenデータベースを指定します。
TimesTen_connection_stringは、少なくともDSN属性およびUID属性を含むTimesTen接続文字列です。UID属性をTimesTenキャッシュ・マネージャ・ユーザーに設定します。

例:

"DSN=ttca;UID=user"

接続文字列からPWD属性が省略されている場合は、ttCacheAdvisorによりTimesTenキャッシュ・マネージャー・ユーザーのパスワードを求めるプロンプトが表示されます。また、接続文字列からOraclePWD属性が省略されており、-evalSqlPerfオプションが指定されている場合は、ttCacheAdvisorによりOracle Databaseキャッシュ管理ユーザーのパスワードを求めるプロンプトが表示されます。

ttIsqlは、ttCacheAdvisorが起動されるホストからの直接接続を使用してTimesTenデータベースに接続可能である必要があります。TimesTenデータベースは、ttCacheAdvisorを起動する前に、『Oracle TimesTen Application-Tier Database Cacheユーザーズ・ガイド』のCache Advisorの使用に関する説明に示すように、TimesTenキャッシュによって使用されるように設定する必要があります。

-V | -version

ttCacheAdvisorのリリース番号を出力し、終了します。

-where '(predicate)'

読取り専用キャッシュ・グループを使用している場合は、表に対してWHERE句を指定します。TimesTenは、AWTキャッシュ・グループに対するこのオプションの値は無視します。
predicateの書式は、キャッシュ表定義で使用できる有効な任意のTimesTen WHERE句です。

-whereオプションを-addオプションとともに使用する場合、'(predicate)'は必須で、-dropオプションとともに使用する場合は任意指定です。

-writethruThreshold percent%

更新操作または書込み操作のしきい値をパーセントで指定します(接尾辞の%文字を含む)。表または関連する表セットに対するワークロードの更新操作の割合が、指定したしきい値以下の場合、ttCacheAdvisorはOracle Database表をキャッシュするために読取り専用キャッシュ・グループを推奨します。それ以外の場合、ttCacheAdvisorは非同期ライトスルー(AWT)キャッシュ・グループを推奨します。
デフォルトのしきい値はゼロ(0)です。これは、表または関連する表セットに対する更新操作がワークロードに少なくとも1つ含まれている場合、ttCacheAdvisorはAWTキャッシュ・グループを推奨することを意味します。

高度なオプション

高度なCache Advisorユーザーに対しては次のオプションをお薦めします。これらのオプションを-exportや-importオプションとともに使用して、ファイル転送パフォーマンスを向上できます。

オプション

説明

-ftp network_connection_string

ターゲットOracle Database、リポジトリOracleシステムおよびTimesTenデータベース間でファイルを転送するためのネットワーク接続を指定します。
network_connection_stringは、[user_name][@host_name]として指定します。user_nameのデフォルト値はttCacheAdvisorを実行するオペレーティング・システム・ユーザーの名前です。host_nameのデフォルト値は、-oraTargetオプションと一緒に使用される場合はOracleターゲット・ホスト名で、-oraRepositoryオプションと一緒に使用される場合はOracleリポジトリ・ホスト名です。匿名FTPアクセスが指定された場合は、パスワードは必要ありません。それ以外の場合、一連のファイルを他のホストにコピーするためにttCacheAdvisorがホストへのアクセスを必要とするときには常に、ftpによりパスワードを求めるプロンプトが表示されます。

デフォルトで、Cache Advisorは-oraConnオプションで指定されたOCI接続を使用してファイルを転送します。-exportまたは-importオプションを使用するときに、-ftpを使用するとファイル転送パフォーマンスを向上できます。匿名のftpアクセスが有効になっていない場合に、パスワードを求めるプロンプト表示によりパフォーマンスが低下する可能性があります。-ftpオプションを使用するには、ディレクトリを-ftpオプションで使用できるように構成する必要があります。

-ftpオプションは、ターゲットに適用するかリポジトリに適用するかを示す、-oraTargetまたは-oraRepositoryオプションのいずれかの前に置く必要があります。

-oraDirNfs path

ターゲットOracle Databaseシステム、リポジトリOracle Databaseシステム、およびTimesTenデータベース・システム間でファイルを転送するためのネットワーク接続を指定します。
pathとは、Advisorが起動されたネットワーク接続しているTimesTenシステムのディレクトリ・パスで、-oraDirObjectオプションにより指定されるOracleディレクトリ・オブジェクトに対応しています。

-oraDirNfsオプションは、ターゲットに適用するか、リポジトリに適用するかを示す、-oraTargetまたは-oraRepositoryオプションのいずれかの前に置く必要があります。

デフォルトで、Cache Advisorは-oraConnオプションで指定されたOCI接続を使用してファイルを転送します。-exportまたは-importオプションを使用するときに、-oraDirNfsを使用するとファイル転送パフォーマンスを向上できます。-oraDirNfsオプションを使用するには、ディレクトリを-oraDirNfsオプションで使用できるように構成する必要があります。

-oraDirObject Oracle_directory_object

ttCacheAdvisorがデータ・ポンプを使用して、ワークロードおよびスキーマ定義をダンプ・ファイルからインポートしたり、ダンプ・ファイルへエクスポートするために使用するOracle Databaseディレクトリ・オブジェクトを指定します。このディレクトリ・オブジェクトは、-oraTargetオプションと一緒に使用されている場合は、ターゲットOracle Databaseのホスト上のローカル・ファイル・システムのディレクトリ・パスを参照する必要があり、あるいは-oraRepositoryオプションと一緒に使用されている場合は、リポジトリOracle Databaseのホスト上のローカル・ファイル・システムのディレクトリ・パスを参照する必要があります。デフォルトのディレクトリ・オブジェクトはTTCA_DIRECTORYで、Cache Advisorのセットアップの間に作成されます。TTCA_DIRECTORYディレクトリ・オブジェクトは、-oraDirNfsまたは-ftpオプションとともに使用するように構成されていません。-oraDirNfsまたは-ftpオプションを使用する場合には、-oraDirObjectオプションを使用してください。
-oraDirObjecオプションは、ターゲットに適用するかリポジトリに適用するかを示す、-oraTargetまたは-oraRepositoryオプションのいずれかの前に置く必要があります。

例

30分間、ターゲット・データベースに対してSQLワークアラウンドを収集します。ワークロードの取得前に、ターゲット・データベースの共有プールをフラッシュします。ワークロードを分析し、./testtaskディレクトリにレポートを作成します。

% ttCacheAdvisor -oraTarget -oraConn orauser@targetdb \
-oraRepository -oraConn advisor@repositorydb \
-ttConn "DSN=cacheadvisor;UID=cacheuser" \
-captureCursorCache 30 -flushSharedPool -task testtask

15分間、ターゲット・データベースに対してSQLワークアラウンドを収集します。TimesTenデータベースおよびターゲット・データベースで実行されたすべてのSQL文のパフォーマンスを評価します。HTMLレポート・ファイルを/home/ttuser/cacheadvreportディレクトリに書き込みます。

% ttCacheAdvisor -oraTarget -oraConn orauser@targetdb \
-oraRepository -oraConn advisor@repositorydb \
-ttConn "DSN=cacheadvisor;UID=cacheuser" \
-report /home/ttuser/cacheadvreport -captureCursorCache 15 -evalSqlPerf

10分間、ターゲット・データベースに対してSQLワークアラウンドを収集します。ワークロードの取得前に、ターゲット・データベースの共有プールをフラッシュします。/home/ttuserディレクトリに書き込まれたcacheadvcapture.zipという名前の1つのファイルに、取得したワークロードをエクスポートします。

% ttCacheAdvisor -oraTarget -oraConn orauser@targetdb \
-captureCursorCache 10 -flushSharedPool -export -zip \
/home/ttuser/cacheadvcapture

/home/ttuser/cacheadvcapture.zipファイルからSQLワークロードをインポートし、分析します。HTMLレポート・ファイルを/home/ttuser/cacheadvreportディレクトリに書き込みます。

% ttCacheAdvisor -oraTarget -oraConn orauser@targetdb \
-oraRepository -oraConn advisor@repositorydb \
-ttConn "DSN=cacheadvisor;UID=cacheuser" \
-report /home/ttuser/cacheadvreport -task temptask \
-import /home/ttuser/cacheadvcapture

ttCapture

説明

コマンドの使用時にTimesTenの状態に関する情報が収集されます。この情報は、問題を診断する場合に役立つことがあります。TimesTenカスタマ・サポートでは、現場のカスタマの問題を診断するために、繰り返し追加情報の提供をお願いする必要がある場合があります。

TimesTenカスタマ・サポートでは、このユーティリティで収集された情報の提供をお願いする場合があります。この情報は、サポート電子メールで送信できます。

このユーティリティではエラーの解釈は行われません。状態に関する情報のみが収集されて、ttCaptureユーティリティを起動したディレクトリにあるttcapture.date.number.logファイルに出力が送信されます。通常、このユーティリティではサポート事例に関係する一般的な情報が収集されます。

注意:
ディレクトリとファイル名は、それらの間にスペースがある場合には常に二重引用符で囲む必要があります。

必要な権限

このユーティリティには、インスタンス管理者の権限が必要です。

接続文字列またはDSNに認証情報が指定されていない場合、続行する前にユーザーIDおよびパスワードの入力が求められます。

構文

ttCapture {-h | -help | -?}
ttCapture {-V | -version}
ttCapture [-noinstinfo] [-nosysinfo] [-stdout | -dest dir] [-logdir dir]
[dspath | DSN]
ttCapture [-noinstinfo] [-nosysinfo] [-stdout | -dest dir] [-logdir dir]
[-noconnect] [dspath | DSN]
ttCapture -noconnect [dspath | DSN]

オプション

ttCaptureには次のオプションがあります。

オプション

説明

-dest dir

指定されたディレクトリに出力ファイルを書き込みます。

DSN

チェックするデータベースのODBCデータソース名を指定します。

dspath

評価するデータベースの完全修飾名を指定します。これは接続に関連付けられたDSNではなく、データベースのODBC定義でDataStore=パラメータに指定した、データベースに関連付けられた完全修飾データベース・パス名です。
たとえば、ファイル/home/payroll/2011.ds0、/home/payroll/2011.ds1およびいくつかのトランザクション・ログ・ファイル/home/payroll/2011.lognからなるデータベースの場合、dspathは/home/payroll/2011です。

注意: DSNとdspathオプションは相互に排他的です。いずれのオプションも指定しない場合、ttCaptureはデータベース情報を表示しません。

-h
-help

-?

使用方法のメッセージを出力して終了します。

-logdir dir

ログ・ディレクトリの位置を指定します。-dspathオプションを付けて使用する必要があります。指定しない場合、ログ・ディレクトリを使用できないことがあります。

-noconnect

ユーティリティがDSNに接続せずに、DSNの情報を取得する必要があることを指定します。
指定された場合、ttConfiguration出力やレプリケーション・スキームなどの一部の情報が出力には含まれなくなります。

このオプションは、大規模なデータベースをロードすることを望まない場合や接続障害で問題を報告する際に役立ちます。

-noinstinfo

ttCaptureがインストール情報を取得しないことを示します。

-nosysinfo

ttCaptureがシステム情報を取得しないことを示します。

-stdout

UNIXシステムの場合、すべての出力はファイルに書き込まれるのではなく、ttCaptureによってstdoutに書き込まれます。Windowsでは、ttCaptureによってコマンド・プロンプトに書き込まれます。

-V | -version

ttCaptureのリリース番号を出力し、終了します。

例

test_dbデータベースのデータを収集し、データベースのチェックポイント・ファイルをディレクトリD:\my_data\recover\test_dbに書き込むには、次のコマンドを使用します。

ttCapture -dest "D:\my_data\recover\test_db" test_db

注意

このユーティリティは、TimesTen Data Managerがインストールされている場合にのみサポートされます。

ttCheck

説明

TimesTenデータベースの内部一貫性チェックを行います。チェックする構造とチェックのレベルを指定できます。

必要な権限

このユーティリティには、ADMIN権限が必要です。

接続文字列またはDSNに認証情報が指定されていない場合、続行する前にユーザーIDおよびパスワードの入力が求められます。

構文

ttCheck {-h | -help | -?}
ttCheck {-V | -version}
ttCheck [ [-blkDir] [-compHeap] [-header] [-heap] [-indexHeap] [-log]
[-permBlkDir] [-permHeap] [-tempBlkDir] [-tmpHeap]
[-tables tblName [...]] [-users userName [...]]
[-level levelNum] ] [...]
[-m maxErrors] [-f outFile] [-v verbosity]
{DSN | [-connstr] connection_string | dspath}

オプション

ttCheckには次のオプションがあります。

オプション

説明

-blkDir

すべてのブロック・ディレクトリをチェックします。

-compHeap

コンパイル・ヒープ構造をチェックします。

-connStr connection_string

データベース名、サーバー名とDSN(必要に応じて)および関連する接続属性を含むODBC接続文字列。

DSN

チェックするデータベースのODBCデータソース名を指定します。

dspath

チェックするデータベースの完全修飾名。これは、接続に対応付けられたDSNではありません。データベースのDSNでDataStore= parameter接続属性に指定した、データベースに関連付けられた完全修飾データベース・パス名です。
たとえば、ファイル/home/payroll/2011.ds0、/home/payroll/2011.ds1およびいくつかのトランザクション・ログ・ファイル/home/payroll/2011.lognからなるデータベースの場合、dspathは/home/payroll/2011です。

-f outFile

出力ファイル名を指定します。デフォルトはstdoutです。

-h
-help

-?

使用方法のメッセージを出力して終了します。

-header

データベース・ヘッダーの内容をチェックします。

-heap

すべてのヒープ構造をチェックします。

-indexHeap

索引ヒープ構造をチェックします。

-level levelNum

ヘッダー、ブロック・ディレクトリ、ヒープおよび表のチェック・レベルを示します。同一コマンドで異なるレベルを使用して異なる構造をチェックできます。レベル指定は、まだレベル指定が行われていない、コマンド文字列の左側に指定されているすべての構造に適用されます。コマンド文字列に構造が指定されていない場合、レベル指定はすべての構造に適用されます。
1: 健全なバイトと簡単なフィールドをチェックします。たとえば、すべての高水準構造体の妥当性についてenumをカウントします。

2: レベル1のチェックをすべて行い、さらに他の構造のフィールドによって参照される構造の妥当性をチェックします。

3: レベル2のチェックをすべて行い、さらに列値について表の各行をチェックします。たとえば、有効なVARCHAR2とFLOATのサイズをチェックします。

4(デフォルト): レベル3のチェックをすべて行い、さらに各行と各索引の索引/表のマッピングをチェックします。

-log

ログ・バッファをチェックします。

-m maxErrors

レポートするエラーの最大数です。デフォルトは10で、この場合は関連エラーがいくつか追加されてレポートされることもあります。0の場合、ユーティリティは接続のみを行って戻ります。

-permBlkDir

永続パーティションのブロック・ディレクトリをチェックします。

-permHeap

永続ヒープ構造をチェックします。

-tables tblName [...]

tblNameで指定される表をチェックします。

-tempBlkDir

一時パーティションのブロック・ディレクトリをチェックします。

-tmpHeap

一時ヒープ構造をチェックします。

-users userName [...]

userNameで指定されるユーザーの表をチェックします。

-V | -version

ttCheckのリリース番号を出力し、終了します。

-v verbosity

0: 出力なし(プログラムの終了ステータスで、エラーが検出されたかどうかが示されます)。
1(デフォルト): エラー出力のみ。

2: エラー出力および進捗状況のレポート。

例

test_dbデータベースのすべての構造のチェックを行うには、次のように実行します。

ttCheck test_db

test_dbデータベースのすべての構造の健全性チェックを行うには、次のように実行します。

ttCheck -level 1 test_db

test_dbデータベースのすべての表のチェックを行うには、次のように実行します。

ttCheck -tables test_db

test_dbデータベースのすべての表の物理的構造および行内容のチェックを行うには、次のように実行します。

ttCheck -tables -level 3 test_db

test_dbデータベースのすべてのヒープ構造、行内容および索引の健全性チェックを行うには、次のように実行します。

ttCheck -heap -level 1 -tables -level 4 test_db

test_dbデータベースの表tab1およびtab2の物理的構造および行内容のチェックを行うには、次のように実行します。

ttCheck -tables tab1 tab2 -level 3 test_db

注意

ttCheckによって返される情報は、主にTimesTenカスタマ・サポートによってTimesTenデータベースの内部データ構造の問題を診断するために使用されますが、システム管理者および開発者にとって役立つ場合があります。

ttCheckユーティリティは、システム上にアクティブなトランザクションがないときに実行する必要があります。

ttCheckユーティリティは、データベースの他の表と同じようにビューのチェックも行います。ただし、ビューの問合せの結果とビューの内容が一致するかどうかは確認できません。

構造を指定しない場合、ttCheckはすべての構造をチェックします。指定した表の名前やユーザーが検出されない場合は、エラーは返されません。

このユーティリティの実行には、時間がかかる場合があります。冗長レベル2によって、進捗状況のレポートを出力できます。

このユーティリティは、TimesTen Data Managerがインストールされている場合にのみサポートされます。

ttCWAdmin

説明

Oracle Clusterwareの高可用性フレームワークを利用するTimesTenアクティブ・スタンバイ・ペアを管理します。このユーティリティは、アクティブ・スタンバイ・ペアおよび対応するClusterwareリソースを管理するために、管理プロセスを起動し、スクリプトを生成し、その他の機能を実行します。

Oracle Clusterwareを使用してTimesTenアクティブ・スタンバイ・ペアを管理する方法の詳細は、『Oracle TimesTen In-Memory Database開発者および管理者ガイド』を参照してください。

次のコマンドは、高度な高可用性がある場合にのみ使用できます。

- ttCWAdmin -addMasterHosts

- ttCWAdmin -addSubscriberHosts

- ttCWAdmin -createVIPs

- ttCWAdmin -delMasterHosts

- ttCWAdmin -delSubscriberHosts

- ttCWAdmin -dropVIPs

基本的な高可用性の場合、これらのコマンドは失敗します。

必要な権限

Windows 2008では、管理者権限を持つユーザーは、すべてのコマンドを管理者として実行できます。その他のサポートされているWindowsプラットフォームでは、管理者権限を持つユーザーは、このユーティリティのすべてのコマンドを実行できます。

UNIXでは、rootユーザーはこのユーティリティのすべてのコマンドを実行できます。rootユーザーがこれらのコマンドを実行する必要があります。

- ttCWAdmin -addMasterHosts

- ttCWAdmin -addSubscriberHosts

- ttCWAdmin -createVIPs

- ttCWAdmin -delMasterHosts

- ttCWAdmin -delSubscriberHosts

- ttCWAdmin -ocrConfig

- ttCWAdmin -dropVIPs

管理ユーザーは、このユーティリティのその他すべてのコマンドを実行できます。

接続文字列またはDSNに認証情報が指定されていない場合、続行する前にユーザーIDおよびパスワードの入力が求められます。

構文

ttCWAdmin {-h | -help | -?}

ttCWAdmin {-V | -version}

ttCWAdmin -init [-hosts "host_name1, host_name2[, ...]"]

ttCWAdmin {-createVIPs | -dropVIPs | -create | -drop | -restore | -start |
-stop | -status} [-ttclusterini path] [-dsn DSN]

ttCWAdmin -switch [-timeout seconds] -dsn DSN

ttCWAdmin -relocate -dsn DSN

ttCWAdmin -reauthenticate -dsn DSN

ttCWAdmin -ocrConfig

ttCWAdmin -beginAlterSchema -dsn DSN

ttCWAdmin -endAlterSchema -dsn DSN

ttCWAdmin -addMasterHosts [-hosts "host_name1, host_name2[, ...]"] -dsn DSN

ttCWAdmin -delMasterHosts [-hosts "host_name1, host_name2[, ...]"] -dsn DSN

ttCWAdmin -addSubscriberHosts [-hosts "host_name1, host_name2[, ...]"] -dsn DSN

ttCWAdmin -delSubscriberHosts [-hosts "host_name1, host_name2[, ...]"] -dsn DSN

ttCWAdmin -start [-noapp] -dsn DSN

ttCWAdmin -stop -dsn DSN

ttCWAdmin -startapps -dsn DSN

ttCWAdmin -stopapps -dsn DSN

ttCWAdmin -shutdown [-hosts "host_name1, host_name2[, ...]"]

オプション

ttCWAdminには次のオプションがあります。

オプション

説明

-addMasterHosts

高可用性が採用されている場合、マスター・ホストのプールにスペア・ホストを動的に追加します。コマンドラインでは、複数のホスト名をカンマで区切ります。
UNIXシステムでは、rootユーザーのみがこのコマンドを実行できます。

-addSubscriberHosts

高可用性が採用されている場合に、サブスクライバ・ホストのプールにスペア・ホストを動的に追加します。コマンドラインでは、複数のホスト名をカンマで区切ります。
UNIXシステムでは、rootユーザーのみがこのコマンドを実行できます。

-beginAlterSchema

アクティブ・スタンバイ・ペア・スキームの新しいスキーマ・オブジェクトを自動的に追加できない場合に、アクティブ・スタンバイ・ペアのレプリケーション・スキームに対するキャッシュ・グループの変更、追加または削除を手動で行うことができます。また、PL/SQLプロシージャ、順序、マテリアライズド・ビュー、データを含む表の索引を作成することも可能です。Oracle Clusterwareで管理されない読取り専用のサブスクライバを追加できます。オブジェクトをスキーマに追加すると、アクティブ・スタンバイ・ペアは停止しますが、グリッドを使用している場合は、アクティブ・ノードはアタッチされたままになります。
関連項目: -endAlterSchema。

-create

指定したDSNのアクティブ・スタンバイ・ペアのレプリケーション・スキームを作成し、関連するアクション・スクリプトを作成します。
このコマンドの内容は次のとおりです。

- ADMIN権限を持つTimesTen内部ユーザーの名前の入力を求めます。TimesTenはこの内部ユーザーを使用して、アクティブ・スタンバイ・ペアを作成します。キャッシュ・グループがOracle Clusterwareによって管理される場合(cluster.oracle.iniで属性CacheConnect=Yの場合)、TimesTenキャッシュ・マネージャのユーザー名を入力します。

- 入力したユーザー名のTimesTenパスワードの入力を求めます。

- キャッシュ・グループを使用する場合、キャッシュ・マネージャと同じ名前のOracle Databaseユーザーのパスワードの入力を求めます。このパスワードは、キャッシュ・マネージャ・ユーザーが接続する場合、OraclePWD接続属性に指定されます。このOracle Databaseユーザーは、キャッシュ・グループの自動リフレッシュ状態を設定するために使用されます。

- 上記の情報を暗号化するために使用するランダムな文字列の入力を求めます。

-createVIPs

アクティブ・スタンバイ・ペアの仮想IPアドレスを作成します。DSNを指定しない場合は、そのTimesTenインスタンス管理者が管理する、すべてのアクティブ・スタンバイ・ペアの情報と、Oracle Clusterwareで管理されるTimesTenインスタンス名が表示されます。

-delMasterHosts

高可用性が採用されている場合、マスター・ホストのプールからスペア・ホストを動的に削除します。コマンドラインでは、複数のホスト名をカンマで区切ります。
指定されたホストがスペア・ホストでない場合、コマンドは失敗します。

UNIXシステムでは、rootユーザーのみがこのコマンドを実行できます。

-delSubscriberHosts

高可用性が採用されている場合に、サブスクライバ・ホストのプールからスペア・ホストを動的に削除します。コマンドラインでは、複数のホスト名をカンマで区切ります。
指定されたホストがスペア・ホストでない場合、コマンドは失敗します。

UNIXシステムでは、rootユーザーのみがこのコマンドを実行できます。

-drop

アクティブ・スタンバイ・ペアのレプリケーション・スキームを削除し、そのアクション・スクリプトを削除します。

-dropVIPs

アクティブ・スタンバイ・ペアの仮想IPアドレスを削除します。

-endAlterSchema

このオプションは、-beginAlterSchemaオプションを使用した操作後に発行されます。オブジェクトがスキーマに追加された後にアクティブ・スタンバイ・ペアをロール・アウトし、新しいレプリケーションのチェックサムを記録します。古いスタンバイは破棄され、複製により再作成されます。

-h
-help

-?

使用方法のメッセージを出力して終了します。

-init

TimesTenクラスタ・エージェントを起動します。

-ocrConfig

TimesTenクラスタ情報は、Oracle Cluster Registry(OCR)に保存されます。このオプションは管理ユーザーをOCRに登録します。クラスタの初期化手順を実行する前に、管理ユーザーを登録しておく必要があります。
UNIXおよびLinuxシステムでは、クラスタを作成する前に、rootユーザーとしてログインし、システムのホストからこのコマンドを実行します。

Windowsシステムでは、インスタンス管理者でログインして、このコマンドを実行します。

停止している既存のクラスタを起動する場合は、この手順を実行する必要はありません。

-reauthenticate

このコマンドは、ユーザー名やパスワードが変更された後に、これらを再認証します。1つのパスワードしか変更されない場合でも、このコマンドはすべてのユーザー名およびパスワードの入力を求めます。

- ADMIN権限を持つTimesTen内部ユーザーの名前の入力を求めます。TimesTenはこの内部ユーザーを使用して、アクティブ・スタンバイ・ペアを作成します。キャッシュ・グループがOracle Clusterwareによって管理される場合(cluster.oracle.iniで属性CacheConnect=Yの場合)、TimesTenキャッシュ・マネージャのユーザー名を入力します。

- 入力したユーザー名のTimesTenパスワードの入力を求めます。

- キャッシュ・グループを使用する場合、キャッシュ・マネージャと同じ名前のOracle Databaseユーザーのパスワードの入力を求めます。このパスワードは、キャッシュ・マネージャ・ユーザーが接続する場合、OraclePWD接続属性に指定されます。このOracle Databaseユーザーは、キャッシュ・グループの自動リフレッシュ状態を設定するために使用されます。

- 上記の情報を暗号化するために使用するランダムな文字列の入力を求めます。

詳細は、『Oracle TimesTen In-Memory Database開発者および管理者ガイド』のOracle Clusterwareを使用した場合のユーザー名またはパスワードの変更に関する説明を参照してください。

-relocate

データベースをローカル・ホストから、cluster.oracle.ini構成ファイル内のMasterHosts属性で指定されている次に使用可能なスペア・ホストに再配置します。使用可能なスペア・ホストがない場合、エラーが返されます。
ローカル・ホスト上でデータベースがアクティブな場合、同一クラスタのリモート・スタンバイ・ストアがアクティブになるように、最初にロールが元に戻されます。スペア・ホスト上に新しく移行されたデータベースは、常にスタンバイ・データベースになります。これは、高可用性が採用されているときに、ホストをオフラインにする必要がある場合、データベースを強制的に再配置するのに役立ちます。基本的な高可用性(HA)が同一クラスタにデプロイされている場合、このコマンドは失敗します。

-restore

RepBackupDirで指定したバックアップからアクティブ・マスター・データベースをリストアします。AutoRecoverが有効なときには、このコマンドを使用しないでください。

-shutdown

TimesTenクラスタ・エージェントを停止します。

-start [-noapp]

クラスタ・アクティブ・スタンバイ・ペアを起動します。これにより、アクティブなデータベース上のすべてのエージェントが起動され、必要に応じて複製によりスタンバイ・データベースおよびサブスクライバ・データベース(ある場合)が作成され、続いてそれらのデータベース上のすべてのエージェントが起動します。-noappを指定すると、アプリケーションは起動されません。後ほどアプリケーションを起動するには、-startappsオプションを使用できます。

-startapps

クラスタ内のアプリケーションを起動します。

-stopapps

クラスタのアプリケーションを停止します。

-status

クラスタのリソースのステータスを取得します。

-stop

レプリケーション・エージェントとキャッシュ・エージェントを停止し、アクティブ・スタンバイ・ペアの両方のデータベースからアプリケーションを切断します。また、Oracle Clusterwareで管理されているキャッシュ・グリッドからグリッド・メンバーを自動的にデタッチします。

-switch

クラスタ内でアクティブ・スタンバイ・ペアのロールを元に戻します。スタンバイ・データベースは新たにアクティブになり、既存のアクティブ・データベースがスタンバイ・データベースになります。

-timeout seconds

-switchオプションのタイムアウト値を指定します。0を超える整数値を指定します。デフォルトは900秒です。
無効な値を入力した場合、TimesTenではデフォルト値の900秒が使用されます。

タイムアウト時間が過ぎた場合、TimesTenからエラーメッセージが返され、スタンバイ・データベースの検証に失敗します。

-dsn DSN

アクティブ・スタンバイ・ペアのDSNを指定します。

-hosts "host_name1, host_name2[, ...]"

TimesTenクラスタ・エージェントを起動または停止するホストを指定します。このオプションを指定しない場合、TimesTenクラスタ・エージェントはすべてのホストで起動または停止されます。

-ttclusterini path

cluster.oracle.iniファイルのフルパス名を指定します。デフォルトの場所はデーモン・ホーム・ディレクトリにあります。デフォルトの場所をお薦めします。

-V | -version

ttCWAdminのリリース番号を出力し、終了します。

例

DSN clusterDSNを使用して、Oracle Clusterwareで管理されるアクティブ・スタンバイ・ペアを作成および起動するには、次のように入力します。

ttCWAdmin -create -dsn clusterDSN
ttCWAdmin -start -dsn clusterDSN

DSN clusterDSNを使用して、Oracle Clusterwareで管理されるアクティブ・スタンバイ・ペアを停止および削除するには、次のように入力します。

ttCWAdmin -stop -dsn clusterDSN
ttCWAdmin -drop -dsn clusterDSN

注意

Oracle ClusterwareをTimesTenで使用する場合、次のコマンドおよびSQL文は使用できません。

- CREATE ACTIVE STANDBY PAIR、ALTER ACTIVE STANDBY PAIRおよびDROP ACTIVE STANDBY PAIR SQL文。

- ttAdminユーティリティの-cacheStartおよび-cacheStopオプション(アクティブ・スタンバイ・ペアの作成後)。

- ttRepAdminユーティリティの-duplicateオプション。

- ttRepStartおよびttRepStop組込みプロシージャ。

- クラスタ内のアクティブ・スタンバイ・ペアがグリッドのメンバーである場合は、キャッシュ・グリッドを管理するための組込みプロシージャ。

- ttAdminユーティリティの-repStartおよび-repStopオプション。

また、ttCWAdmin -shutdownをコールする前にttDaemonAdmin -stopをコールしないでください。

Oracle Clusterwareと統合されたTimesTenでは、このような操作は、ttCWAdminユーティリティおよびcluster.oracle.iniファイル内の属性によって行われます。

ttDaemonAdmin

説明

TimesTenのメイン・デーモンおよびサーバーを起動および停止します。

必要な権限

このユーティリティには、インスタンス管理者の権限が必要です。

構文

ttDaemonAdmin {-h | -help | -?}
ttDaemonAdmin {-V | -version}
ttDaemonAdmin [-force] {-start | -stop | -restart}
ttDaemonAdmin [-startserver | -restartserver]
ttDaemonAdmin [-force] -stopserver
ttDaemonAdmin -verbose

オプション

ttDaemonAdminには次のオプションがあります。

オプション

説明

-h
-help

-?

使用方法のメッセージを出力して終了します。

-force

警告が返された場合にも、TimesTenメイン・デーモンを起動または停止します。または-stopserverと併用すると、ただちにサーバー・プロセスを停止します。

-restart

TimesTenメイン・デーモンを再起動します。

-restartserver

TimesTen Serverを再起動します。

-start

TimesTenメイン・デーモンを起動します。

-startserver

TimesTen Serverデーモンを起動します。

-stop

TimesTenメイン・デーモンを停止します。

-stopserver

TimesTen Serverデーモンを停止します。
-forceオプションを使用しない場合、TimesTenデータベースに対するクライアント/サーバー接続は、処理中のリクエストが完了してから正常に切断され、その後サーバーが終了します。

-forceオプションを使用する場合、TimesTenデータベースに対するクライアント/サーバー接続は強制的にただちに切断され、その後サーバーが終了します。

-V | -version

ttDaemonAdminのリリース番号を出力し、終了します。

注意

TimesTen Serverのオプションに対する変更は一時的なものです。TimesTen Serverのオプションの設定を永続的または無効にするには、ttendaemon.optionsファイルのオプションを変更する必要があります。

-forceオプションを使用すると、データベースがリカバリ処理を必要とする状態になる場合があるため、注意が必要です。

このユーティリティをWindows Vista上で使用する場合は、Windowsの管理者権限で実行する必要があります。デーモンを停止するときは(ttDaemonAdmin -stop)、まずデータベースに対するすべてのアプリケーション接続を停止します。また、レプリケーション・エージェントとキャッシュ・エージェントを実行している場合は、これらも停止します。これにより、デーモンを再起動する際の起動時間が短縮されます。また、アプリケーションの接続やエージェントを停止しないと、データベースが無効になる可能性があります。

Oracle Clusterwareエージェントを起動中の場合は、TimesTenメイン・デーモン(ttDaemonAdmin -stop)を停止する前に、ローカル・ホスト上でエージェントを停止する必要があります。Clusterwareエージェントを停止しない場合は、このコマンドによってメイン・デーモンは一時的に停止しますが、その後再起動します。Oracle Clusterwareエージェントを停止するには、次のコマンドを使用します。

ttcwadmin -shutdown -hosts localhost

このユーティリティを使用してサーバーを再起動する場合、TimesTenデーモンはttendaemon.optionsファイルを読み取って、前回の読取り後に変更があったかどうかを確認します。ファイルが変更されていた場合、TimesTenは次のオプションの値を確認します。

-server -serverShmIpc -serverShmSize -noserverlog

関連項目

すべてのデーモン・オプションの説明およびttendaemon.optionsファイルの変更手順については、『Oracle TimesTen In-Memory Databaseオペレーション・ガイド』のTimesTenデーモン・オプションの管理に関する説明を参照してください。

ttDaemonLog

説明

TimesTenデーモン(WindowsではTimesTen Data Managerサービスと呼ばれます)とそのサブデーモンおよびエージェントは、エラーおよびステータス・メッセージを次のデーモン・ログに書き込みます。

- 実行が必要になる可能性があるアクションなど、注意する必要がある情報を含むユーザー・エラー・ログ

- ユーザー・エラー・ログに含まれるすべての情報に加えて、TimesTenカスタマ・サポートによって使用される情報が含まれるサポート・ログ

ttDaemonLogユーティリティを使用すると、次の操作を実行できます。

- ユーザー・エラー・ログで報告されるイベントのタイプとメッセージのカテゴリを管理します。

- ログから標準出力にすべてのメッセージまたは選択したカテゴリのメッセージを表示します。

必要な権限

このユーティリティには、インスタンス管理者の権限が必要です。

構文

ttDaemonLog {-h | -help | -?}
ttDaemonLog {-V | -version}
ttdaemonLog [-show type] [-b | -r | -s] [-f] [-maxlines]
[-loglevel level [DSN | -connstr connStr]]
[-[no]logcomponent component [DSN | -connstr connStr]]
[-logreset] [-msg messagestring] [-setquiet | -setverbose]
[-file filename] [-facility name]
[-n computer]

注意:

- -fileおよび-facilityオプションはUNIXでのみ適用されます。

- -nオプションは、Windowsでのみ適用され、通常の使用には適用されません。

オプション

ttDaemonLogには次のオプションがあります。

オプション

説明

-b

TimesTenによって生成されたすべてのログ・エントリを出力します。

-f

ログの終わりに達しても、ttDaemonLogは終了せずに継続し、定期的にログのポーリングを行って、追加のTimesTenログ・レコードを検索して表示します。これは、リアルタイムで更新されるログ・データを表示する場合などに役立ちます。

-facility name

使用されているsyslog機能名を指定します。
注意: このオプションはUNIXにのみ適用されます。

-file filename

TimesTenログ・メッセージを記録するファイルを指定します。
指定しない場合は、システムのsyslog設定が調べられ、TimesTenメッセージの記録先が決定されます。

注意: このオプションはUNIXにのみ適用されます。

-h
-help

-?

ttDaemonLog使用情報を表示して終了します。

-maxlines

-fが指定された場合、ログの最終行の最大数はデフォルトで40行です。0が指定された場合、最大値はありません。

-logcomponent component
-nologcomponent component

デフォルトでは、すべてのカテゴリのメッセージがログに記録されますが、-logcomponentを使用して、ログに記録するカテゴリを指定したり、-nologcomponentを使用して、ログに記録しないカテゴリを指定することができます。1つのコンポーネントしか指定できませんが、これらのオプションを指定してttDaemonLogを複数回実行し、目的の一連のメッセージを決定できます。
このオプションは、DSNまたは接続文字列が指定されている場合、指定されたデータベースにのみ適用されます。ttDaemonLogを複数回実行し、複数のデータベースに対してこれらのオプションを設定できます。

サポートされるカテゴリは次のとおりです。

ALL (デフォルト): すべてのメッセージが対象です。

CACHE: CACで指定する、キャッシュ・エージェントからのメッセージが対象です。

DAEMON: メイン・デーモンおよびサブデーモンからのメッセージが対象です。

DAEMONDBG: メイン・デーモンおよびサブデーモンからの追加情報が対象です。

REPLICATION: REPで指定する、レプリケーション・エージェントからのメッセージが対象です。

SERVER: TimesTen Serverからのメッセージが対象です。

-loglevel level

サポート・ログに記録されるメッセージのレベルのカットオフを指定します。値が低いほどメッセージ数は少なくなります。(たとえば、レベル5を指定した場合、レベル1、2、3、4または5のメッセージがログに記録されます。)通常、このオプションはカスタマ・サポート使用でのみ適用されます。
このオプションは、DSNまたは接続文字列が指定されている場合、そのデータベースにのみ適用されます。

-logreset

イベント・ロギング・パラメータをリセットします。

-msg messagestring

指定したテキストをTimesTenユーザー・ログに挿入します。

-n computer

異なるコンピュータのログを表示します。対象のコンピュータの汎用命名規則(UNC)名を指定します。
注意: このオプションは、Windows上で、通常の使用ではないTimesTenログ記録用Windowsイベント・ログを使用している場合にのみ適用されます。

-r

TimesTenレプリケーション・エージェント・ログのみを出力します。(-show replicationと同じです。)

-s

TimesTen Serverのログのみを出力します。(-show serverと同じです。)

-setverbose
-setquiet

TimesTen冗長ロギングを有効(-setverbose)または無効(-setquiet)にします。

-show type

ttDaemonLogを使用してログ・メッセージを標準出力に表示する場合、次のタイプのいずれかを指定して-showオプションを使用し、表示されるログ・メッセージをそのタイプのみに限定できます。
all (デフォルト): すべてのメッセージを表示します。

replication: レプリケーション・エージェントからのログ・メッセージのみを表示します。(-rオプションと同じです。)

cache: キャッシュ・エージェントからのログ・メッセージのみを表示します。

server: TimesTen Serverからのログ・メッセージのみを表示します。(-sオプションと同じです。)

注意: -[no]logcomponentを使用してログ記録が無効にされているカテゴリは表示できません。

-V | -version

ttDaemonLogのリリース番号を出力し、終了します。

例

デフォルトでは、ttDaemonLogユーティリティでは、すべてのTimesTenコンポーネントのメッセージおよびエラーが記録されます。-nologcomponentオプションを設定すると、ログに書き込まれる範囲を絞り込むことができます。このオプションは、選択したデータベースまたはすべてのデータベースに適用できます。

ローカル・コンピュータ上のTimesTenのデーモンおよびサーバーからのすべての出力を表示するには、次のように入力します。

ttDaemonLog

すべてのデータベースのレプリケーションに関連するメッセージおよびエラーがログに書き込まれないようにするには、次のように入力します。

ttDaemonLog -nologcomponent replication

masterdsnデータベースのレプリケーションに関連するメッセージおよびエラーがログに書き込まれないようにするには、次のように入力します。

ttDaemonLog -nologcomponent replication masterdsn

レプリケーションおよびTimesTen Cacheの両方のエラーおよびメッセージがログに書き込まれないようにするには、次のように入力します。

ttDaemonLog -nologcomponent replication
ttDaemonLog -nologcomponent cache

-nologcomponentオプションを使用してコンポーネントを無効にした後にそれを再度有効にするには、-logcomponentオプションを使用できます。たとえば、前述の例で示したように、レプリケーションおよびTimesTen Cacheのメッセージを無効にした後に、レプリケーション・メッセージを次のように再度有効にできます。

ttDaemonLog -logcomponent replication

すべてのTimesTenコンポーネントのログへの書込みを再度有効にするには、次のように-logresetオプションを使用します。

ttDaemonLog -logreset

TimesTen Serverは、アプリケーションがクライアントDSNに接続されるか、またはクライアントDSNから切断されるたびにメッセージを生成します(ただし、インストール時にこれらのメッセージの生成を指定している場合)。サーバー・ログ・メッセージのみを表示するには、次のように入力します。

ttDaemonLog -show server

レプリケーション・エージェント・メッセージのみを表示するには、次のように入力します。

ttDaemonLog -show replication

キャッシュ・エージェント・メッセージのみを表示するには、次のように入力します。

ttDaemonLog -show cache

TimesTenプロセスからのすべてのメッセージを表示するには、次のように入力します。

ttDaemonLog -show all

ロギングをデフォルトの冗長レベルにリストアするには、-setverboseオプションを使用します。

ttDaemonLog -setverbose

UNIXで、ファイル/var/adm/syslog/syslog.logにログ出力を書き込むには、次のように入力します。

ttDaemonLog -file /var/adm/syslog/syslog.log

UNIXで、ロギングをlocal7機能に送るには、次のように入力します。

ttDaemonLog -facility local7

注意

この情報は、主にTimesTenカスタマ・サポートによる使用を目的としていますが、システム管理者およびシステム開発者に役立つ場合もあります。

このユーティリティは、TimesTen Data Managerがインストールされている場合にのみサポートされます。

冗長ロギングを永続的に設定または無効にするには、ttendaemon.optionsファイルのオプションを変更します。『Oracle TimesTen In-Memory Databaseオペレーション・ガイド』の情報メッセージの変更に関する説明を参照してください。

ttDestroy

説明

すべてのチェックポイント・ファイル、トランザクション・ログおよびデーモン・カタログ・エントリを含む(DSNは含まない)データベースを破棄します。

必要な権限

このユーティリティには、インスタンス管理者の権限が必要です。

構文

ttDestroy {-h | -help | -?}
ttDestroy {-V | -version}
ttDestroy [[-wait] [-timeout secs]] [-force] {-connStr connection_string |
DSN | dspath}

オプション

ttDestroyには次のオプションがあります。

オプション

説明

-connStr connection_string

データベース名、サーバー名とDSN(必要に応じて)および関連する接続属性を含むODBC接続文字列。

DSN

破棄するデータベースのODBCデータソース名を指定します。

dspath

破棄するデータベースの完全修飾名。
これは接続に関連付けられたDSNではなく、データベースのODBC定義でDataStore=パラメータに指定した、データベースに関連付けられた完全修飾データベース・パス名です。

たとえば、ファイル/home/payroll/2011.ds0、/home/payroll/2011.ds1およびいくつかのトランザクション・ログ・ファイル/home/payroll/2011.lognからなるデータベースの場合、dspathは/home/payroll/2011です。

-h
-help

-?

使用方法のメッセージを出力して終了します。

-force

TimesTenの互換性のないバージョンまたは異なるインスタンスのファイルであっても破棄します。

-timeout seconds

ttDestroyが待機する時間を秒単位で指定します。タイムアウト値が指定されない場合、TimesTenは破棄の処理を再試行する前に5秒間待機します。

-V | -version

ttDestroyのリリース番号を出力し、終了します。

-wait

データベースが使用中などの一時的な条件によりデータベースを破棄できない場合、成功するまで継続的にttDestroyに破棄の処理を再試行させます。

例

ttDestroy /users/pat/TimesTen/Daily/F112697

注意

ttDestroyを使用することが、完全かつ安全にデータベースを削除する唯一の方法です。データベース・チェックポイントやトランザクション・ログ・ファイルを手動で削除しないでください。

このユーティリティは、TimesTen Data Managerがインストールされている場合にのみサポートされます。

破棄するデータベースがキャッシュ・グリッドの一部である場合、ttDestroyはグリッドからデータベースをデタッチします。

ttDestroyでは、自動リフレッシュまたはAWTキャッシュ・グループからのOracle Databaseオブジェクトのクリーンアップは実行されません。データベースに自動リフレッシュまたはAWTキャッシュ・グループがある場合は、cachecleanup.sqlスクリプトを実行してOracle Database内のキャッシュ・オブジェクトをクリーンアップし、データベースが破棄された後にクリーンアップを実行するためのOracle SQLを生成します。

ttIsql

説明

ttIsqlからSQL文を実行し、TimesTen組込みプロシージャをコールできます。SQLは、コマンドラインから対話形式で実行できます。ttIsqlからのSQLの実行の詳細は、-helpfullオプションを使用してください。また、TimesTen組込みプロシージャをコールするには、call procedure-nameを使用します。

[Ctrl]キーを押しながら[C]キーを押すと、ttIsqlコマンドは実行中のODBC関数を取り消そうとします。

UNIXでは、このユーティリティはTimesTen Data Manager DSNで使用できます。クライアント/サーバーDSNには、ttIsqlCSを使用します。

ttIsqlユーティリティは、スクリプトを実行中でもAUTOCOMMITをオンにして起動します。必要に応じてAUTOCOMMITをオフにし、再度オンにできます。

ttIsqlユーティリティの詳細は、『Oracle TimesTen In-Memory Databaseオペレーション・ガイド』の章「ttIsqlユーティリティの使用方法」を参照してください。

必要な権限

このプロシージャには、権限は必要ありません。

構文

ttIsql {-h | -help | -? | -helpcmds | - helpfull}
ttIsql {-V | -version}
ttIsql [-f inputFile] [-v verbosity] [-e commands | sql_statement]
[-interactive] [-N ncharEncoding] [-wait] {-connStr connection_string | DSN}

オプション

ttIsqlには次のオプションがあります。

オプション

説明

-connStr connection_string

データベース名、サーバー名とDSN(必要に応じて)および関連する接続属性を含むODBC接続文字列。

DSN

接続するデータベースのODBCデータソース名を指定します。

-e commands

起動時に実行する、セミコロンで区切ったttIsqlコマンドのリストを指定します。

-f filename

filenameからSQLコマンドを読み取ります。

-h
-help

-?

使用方法のメッセージを出力して終了します。

-helpcmds

対話形式コマンドの短いリストを出力します。

-helpfull

対話形式コマンドの完全な説明を出力します。

-interactive

対話形式モードを強制します。これはemacs comintバッファから実行するときに役立ちます。

-N ncharEncoding

NCHARの出力に使用する文字エンコードを指定します。
有効な値はLOCALEまたはASCIIです。LOCALE(デフォルト)は、出力形式をロケール・ベースで設定します。

値を指定しない場合は、TimesTenではシステム固有の言語文字が使用されます。

-V | -version

ttIsqlのリリース番号を出力し、終了します。

-v verbosity

冗長レベルを指定します。次のいずれかです。
0: エラー情報のみが表示されます。コマンドがすべて成功した場合、出力はありません。

1: コマンドによって生成される基本出力が表示されます。

2(デフォルト): レベル1に加えて、コマンドのより詳細な結果が表示されます。このレベルでは、簡略化されたSQLエラーと情報メッセージが表示されます。また、外部ファイルから読み取られたttIsqlコマンドが画面に表示されます。

3: レベル2に加えて、より詳細なエラー・メッセージと情報メッセージが表示されます。

4: レベル3に加えて、完全なエラー・メッセージと情報メッセージが表示されます。また、準備されたコマンドに関するメッセージ、成功した各コマンドの「success」メッセージおよびXLAレコードの内容も表示されます。

-wait

接続に成功するまで待機します。

コマンド

ttIsqlの「属性の設定および表示」のリストも参照してください。

ブール・コマンドでは、ONおよびOFFまたは1および0の値を使用できます。

ttIsqlには次のコマンドがあります。

コマンド

説明

accept variable[NUM[BER]| CHAR |BINARY_FLOAT | BINARY_DOUBLE] [DEF[AULT]default_value] [PROMPT prompt_text | NOPR[OMPT]] [HIDE]

ユーザーから入力を取得し、変数をDEFINESを使用して定義します。型が指定されている場合には、型の検証をします。ユーザーが[Enter]を押しただけの場合、デフォルト(引用符で囲まれる)が割り当てられます。入力を待つ間、プロンプトが表示されます(プロンプトの表示は抑制できます。)HIDEオプションを使用すると、入力した文字を端末に表示しません(パスワード用)。
HIDEオプションを付けずに指定した場合は、入力を待つ間、プロンプトが表示されます。HIDEオプションを使用すると、入力した文字を端末に表示しません。

allfunctions [[owner_name_pattern.] table_name_pattern]

SYS.ALL_OBJECTSから選択された特定のパターンに一致するすべてのPL/SQLファンクションの名前が単一の列にリストされます。パターンが指定されていない場合、パターンはデフォルトで%になります。
パススルーが有効になっている場合は、Oracle Database内の、パターンに一致するPL/SQLファンクションがリストされます。

functionsコマンドを参照してください。

allindexes [[owner_name_pattern.] table_name_pattern]

SYS.ALL_OBJECTSから選択された入力パターンに一致する表で見つかった索引が示されます。パターンが指定されていない場合、パターンはデフォルトで%になります。
パススルーが有効になっている場合は、Oracle Database内の、パターンに一致する表の索引がリストされます。

indexesコマンドを参照してください。

allpackages [[owner_name_pattern.] table_name_pattern]

SYS.ALL_OBJECTSから選択された特定のパターンに一致するすべてのPL/SQLパッケージの名前が単一の列にリストされます。パターンが指定されていない場合、パターンはデフォルトで%になります。
パススルーが有効になっている場合は、Oracle Database内の、パターンに一致するPL/SQLパッケージがリストされます。

packagesコマンドを参照してください。

allprocedures [[owner_name_pattern.] procedure_name_ pattern]

SYS.ALL_OBJECTSから選択された特定のパターンに一致するすべてのPL/SQLプロシージャの名前が単一の列にリストされます。パターンが指定されていない場合、パターンはデフォルトで%になります。
パススルーが有効になっている場合は、Oracle Database内の、パターンに一致するPL/SQLプロシージャがリストされます。

proceduresコマンドを参照してください。

allsequences [[owner_name_pattern.] table_name_pattern]]

SYS.ALL_OBJECTSから選択された特定のパターンに一致するすべての順序の名前が単一の列にリストされます。パターンが指定されていない場合、パターンはデフォルトで%になります。
パススルーが有効になっている場合は、Oracle Database内の、パターンに一致する表の順序がリストされます。

sequencesコマンドを参照してください。

allsynonyms [[schema_pattern.] object_pattern]]

特定のパターンに一致するすべてのシノニムの名前が単一の列にリストされます。パターンが指定されていない場合、パターンはデフォルトで%になります。
パススルーが有効になっている場合は、Oracle Database内の、パターンに一致する表のシノニムがリストされます。

synonymsコマンドを参照してください。

alltables [[owner_name_pattern.] table_name_pattern]]

SYS.ALL_OBJECTSから選択された特定のパターンに一致するすべての表の名前が単一の列にリストされます。パターンが指定されていない場合、パターンはデフォルトで%になります。
パススルーが有効になっている場合は、Oracle Database内の、パターンに一致する表がリストされます。

tablesコマンドを参照してください。

allviews [[owner_name_pattern.] view_name_pattern]]

SYS.ALL_OBJECTSから選択された特定のパターンに一致するすべてのビューの名前が単一の列にリストされます。パターンが指定されていない場合、パターンはデフォルトで%になります。
パススルーが有効になっている場合は、Oracle Database内の、パターンに一致するビューがリストされます。

waitforコマンドを参照してください。

builtins [builtin_name_ pattern]

特定のパターンに一致するすべてのTimesTen組込みプロシージャの名前が単一の列にリストされます。パターンが指定されていない場合、パターンはデフォルトで%になります。
proceduresコマンドを参照してください。

bye
exit

ttIsqlを終了します。

cachegroups [[cache_group_owner_pattern. cache_group_name_pattern]]

現在接続されているデータソースに定義されているキャッシュ・グループの情報をレポートします。レポートされる情報には、自動リフレッシュ・キャッシュ・グループを含む停止中のデータベースの状態などがあります。
オプションの引数を指定しない場合は、現在のデータソースのすべてのキャッシュ・グループに関する情報がレポートされます。

clearhistory

履歴バッファを消去します。「history」および「savehistory」も参照してください。

clienttimeout
[timeeout seconds]

現在の接続に対して、クライアントのタイムアウト値を秒単位で設定します。値を指定しなかった場合は、現在の値が表示されます。

cachesqlget
[ASYNCONOUS_WRITETOUGH | INCREMENTAL_AUTOREFRESH] [[cache_group_owner.]cache_group_name] {INSTALL | UNINSTALL} [filename]

読取り専用キャッシュ・グループ、増分自動リフレッシュを設定したユーザー管理キャッシュ・グループまたはAWTキャッシュ・グループに関連付けられたOracle Databaseオブジェクトをインストールまたは削除する、Oracle SQL*Plus互換のスクリプトを生成します。
INSTALLを指定した場合、Oracle DatabaseオブジェクトをインストールするOracle SQL文が生成されます。

UNINSTALLを指定した場合、Oracleオブジェクトを削除するOracle SQL文が生成されます。UNINSTALLでキャッシュ・グループを指定しない場合、自動リフレッシュ・ユーザーのアカウントのすべてのOracle Databaseオブジェクトを削除するSQL文が生成されます。

オプションのfilename引数が含まれている場合、生成されたSQL文は指定した外部ファイルに保存されます。既存の外部ファイルがある場合は、ファイルへの書込みが行われる前に、ファイルの内容が破棄されます。

close [connect_id.] command_id]
closeall

接続名(connect_id)およびコマンドID(command_id)で指定されている準備されたコマンドを閉じます。command_idが指定されていない場合は、最新のコマンドが閉じられます。closeallを選択した場合は、現在開いている準備されたコマンドがすべて閉じられます。

cmdcache [[by{sqlcmdid |querytext|owner}] query_subsstring]

TimesTen SQLコマンド・キャッシュの内容を表示します。
SQL問合せの特定の部分を検索するために、sqlcmdid、querytextまたはowner列および問合せの部分文字列を指定します。列を指定しない場合は、querytext列が検索されます。

パススルーが有効になっている場合は、コマンドIDはOracle Databaseには渡されません。

commit

現在のトランザクションを(接続のDurableCommits=1の場合は永続的に)コミットします。

commitdurable

現在のトランザクションを永続的にコミットします。

compact

データベースを縮小します。

compare varA VarB

2つの変数の値を比較して、差異がある場合はレポートします。最初の差異がレポートされます。

connect[connection_string |[[DSN][as]connid [adding] [connection_string | DSN][as connid]

指定したODBC connection_stringでデータベースに接続します。
この書式でパスワードを指定しない場合は、ttIsqlによってパスワードの入力が要求されます。

ユーザーを指定しない場合、ttIsqlによって、オペレーティング・システムに指定された現在のユーザーのユーザー名を使用して接続が試行されます。

as connidを指定した場合は、接続に明示的に名前を付けることができます。connidに使用できるのは英字で始まる最大30文字の英数字のみで、大/小文字を区別する必要があります。connidの名前は、ConnectionName一般接続属性に自動的に指定されます。接続が失敗した場合、現在の接続は、いずれにも接続されないnoneという名前の特別な予約済接続に設定されます。

addingを指定した場合、DSNまたは接続文字列に指定したDSNへの新しい接続が作成されます。

createandloadfromoraquery [owner_name.]table_name [num_threads] query

表名、パラレル・ロードのスレッド数およびOracle SELECT文をとります。
表が存在していない場合はTimesTenに表を作成します。次にOracle Databaseからの問合せ結果を表にロードします。コマンドにより表が作成される場合、その表の列名とタイプは問合せ結果から導出されます。

注意:

- 指定するTimesTen表はシステム表、シノニム、ビュー、マテリアライズド・ビューまたはマテリアライズド・ビューの詳細表、グローバル一時表、キャッシュ・グループ表とすることはできません。

- 問合せはパラメータ・バインディングを持つことができません。

- サポートされていないすべての列タイプは警告となり、ログに記録されます。サポートされていない列データ型についてのコメントが出力で発行されます。

- num_threadsの値を指定しない場合は、デフォルトの4スレッドになります。

- 詳細と使用法の情報については、『Oracle TimesTen In-Memory Databaseオペレーション・ガイド』のOracle DatabaseからTimesTen表へのデータのロードに関する説明を参照してください。

- この処理を実行した後でロールバックまたはコミットを実行する必要があります。

- 組込みプロシージャttLoadFromOracleの説明の「注意」の項も参照してください。

必要な権限

指定した表に対するINSERT権限が必要です。表が存在していない場合はさらに、CREATE TABLE権限も必要です。Oracleセッション・ユーザーは、Oracle Databaseに対して問合せを実行するために必要なすべての権限を持っている必要があります。

define name [= value]

文字列置換別名を定義します。
値を指定しない場合は、指定した名前の現在の定義が表示されます。

コマンド置換を有効にするには、set define onを使用する必要があります。「属性の設定および表示」を参照してください。

describe [[owner_pattern.] name_pattern | procedure_name_pattern |sql_statement | [connect_id.]command_id |*]

引数が[owner_pattern.]name_patternの場合は、表、ビュー、マテリアライズド・ビュー、マテリアライズド・ビュー・ログ、順序、キャッシュ・グループ、PL/SQLファンクション、PL/SQLプロシージャ、PL/SQLパッケージおよびTimesTen組込みプロシージャに関する情報がこの順でリストされます。それ以外の場合は、特定のパターンに一致する特定のオブジェクトがリストされます。
引数がsql_statementの場合は、パラメータおよび結果列に関する説明が表示されます。

passthroughが3に設定されている場合は、Oracle Database内の同じタイプのオブジェクトに関する情報がリストされます。

*を指定した場合は、すべての接続の準備された文がレポートされます。

表示された表がマテリアライズド・ビュー・ログの場合、メッセージは、そのログが表で表示されているマテリアライズド・ビューの名前を示します。表示された表にマテリアライズド・ビュー・ログが記載されている場合、メッセージはマテリアライズド・ビュー・ログの名前を示します。

キャッシュ・グループの表示では、接続中のデータソースに定義されているキャッシュ・グループの情報(自動リフレッシュ・キャッシュ・グループを含む停止中のデータベースの状態など)がレポートされます。

コマンド別名はdescです。

disconnect [all]

データベースから切断します。allが指定されている場合は、すべての接続を切断して閉じます。切断が終了すると、現在の接続は「none」という名前の予約済接続に設定されます。

dssize [k|m|g|t]

データベース・サイズの情報をKB、MB、GBまたはTBの単位で出力します。デフォルトはKBです。出力は、返された単位を示します。

e: msg
PROMPT msg

行末で終了される、指定したメッセージをエコーします。行を終了させるセミコロンは必須ではありません。冗長レベルが0(ゼロ)に設定されている場合、メッセージはエコーされません。

edit [ file | !history_search_command ]

ttIsql editコマンドを使用してファイルを編集するか、またはテキスト・エディタでttIsqlコマンドを編集します。ttIsql editコマンドは、emacs、geditまたはviなどのテキスト・エディタを起動します。
TimesTenは、指定されたfileパラメータに完全一致するファイルが見つからなかった場合、file.sqlを検索します。いずれのファイルも存在しない場合、ttIsqlはファイルfileを使用してエディタを起動します。

現行のttIsqlセッションの履歴リストにあるSQL文を編集できます。ttIsql editコマンドを呼び出す場合、!文字とそれに続くコマンドまたは検索文字列の数を指定します。

history_search_commandパラメータを指定してttIsql editコマンドを実行する場合、テキスト・エディタを終了した後に、ttIsqlはファイルの内容を実行します。ファイルの内容は、単一のttIsqlコマンドとして実行されます。ファイルの内容を実行しない場合、ファイルの内容を削除してファイルを保存してからエディタを終了します。

1度に1つのパラメータのみ使用できます。history_search_commandパラメータは、!文字とそれに続くコマンドまたは検索文字列の数で定義されます。!文字を指定しない場合、ttIsql editコマンドはパラメータをfileとして解釈します。パラメータを指定しない場合または!!を指定しない場合、最後のttIsqlコマンドが編集されます。

ttIsql _EDITOR定義の別名を定義することで、デフォルト・エディタを指定できます。次の例では、デフォルト・エディタをviに設定します。

Command> DEFINE _EDITOR=vi

_EDITOR定義の別名を定義しない場合、ttIsqlは、VISUAL環境変数で指定されたエディタを使用します。_EDITOR定義の別名およびVISUAL環境変数が設定されていない場合、ttIsqlは、EDITOR環境変数で指定されたエディタを使用します。_EDITOR、VISUALおよびEDITORが設定されていない場合、viがUNIX用に使用され、notepad.exeがWindows用に使用されます。

詳細は、『Oracle TimesTen In-Memory Databaseオペレーション・ガイド』のttIsql editコマンドの使用に関する説明を参照してください。

exec [connect_id.] command_id] | PLSQLSTMT

準備されたコマンドcommand_idを
接続connect_idで実行するか、またはPL/SQL文を実行します。

connect_idでは、オプションでttIsql接続の名前が指定されます(command_idは1から255までの整数です)。PLSQLSTMTを指定すると、ttIsqlによって文の先頭にBEGIN、文の末尾にENDがそれぞれ付加されるため、PL/SQL文を実行できるようになります。

引数を指定しない場合は、最新のコマンドが実行されます。

execandfetch [connect_id.]command_id]

接続connect_idに対して準備されたコマンドcommand_idを実行し、すべての結果をフェッチします。command_idを指定しない場合は、最新のコマンドが実行され、すべての結果がフェッチされます。

explain [plan for] {[ Connid.]ttisqlcmdid | sqlcmdid sqlcmdid | sqlstmt |!history}

ttisqlcmdid引数またはsqlcmdid引数で指定された準備済のttIsql文を含め、指定したSQL文の計画について説明します。
sqlcmdid引数で修飾されていない数値は、準備済のttIsql文IDとして解釈されます。

パススルーが有効になっている場合は、コマンドIDはOracle Databaseには渡されません。

fetchall [connect_id.]command_id]

接続connect_idに対して準備されたコマンドcommand_idからすべての結果をフェッチします。
command_idを指定しない場合は、最新のコマンドからの結果がすべてフェッチされます。コマンドはexecを使用して、すでに実行されている必要があります。

fetchone [connect_id.]command_id]

接続connect_idに対して準備されたコマンドcommand_idから1つの結果をフェッチします。
command_idを指定しない場合は、最新のコマンドから1つの結果がフェッチされます。コマンドはexecを使用して、すでに実行されている必要があります。

free [connect_id.] command_id]

接続connect_idに対して準備されたコマンドcommand_idを解放します。
コマンドを指定しない場合は、最新のコマンドが解放されます。

functions [object_name_pattern]

現在のユーザーによって所有されており、特定のパターンに一致するPL/SQLファンクションの名前が単一の列にリストされます。名前パターンが指定されていない場合、パターンはデフォルトで%になります。
パススルーが有効になっている場合は、Oracle Database内の、パターンに一致するPL/SQLファンクションがリストされます。

allfunctionsコマンドを参照してください。

globalprocessing statement

グローバル処理を有効にして、指定した文を実行します。
!コマンドを使用して文を指定することはできません。

help [command [command ...]| all | comments | attributes]

コマンドの簡単なヘルプ情報または詳細なヘルプ情報を出力します。
引数として特定のコマンドを指定した場合は、各コマンドの詳細なヘルプが出力されます。

コマンドの正確な名前がわからない場合は、コマンド名の一部の可能性がある数文字のみを入力します。ttIsqlでは、それらの文字を含むすべてのコマンドのヘルプが検索され、表示されます。

引数としてallを指定した場合は、すべてのコマンドの詳細なヘルプが出力されます。

引数としてcommentsを指定した場合は、スクリプト内でのttIsqlコメントの使用に関する情報が出力されます。

引数としてattributesを指定した場合は、set/show属性に関する情報が出力されます。

引数を指定しない場合は、すべてのコマンドの簡単なヘルプ情報が出力されます。

history
[-r] [num_commands]

以前に実行されたコマンドを表示します。
num_commandsパラメータは、表示するコマンド数を指定します。このパラメータを省略した場合、実行された過去10コマンドがデフォルトで表示されます。

-rパラメータを指定した場合、コマンドは逆の順序で表示されます。

履歴リストには、実行された過去100コマンドが格納されています。履歴を消去するには、clearhistoryコマンドを使用します。

savehistoryコマンドを参照してください。

host os_command

オペレーティング・システムのコマンドを実行します。コマンドはttIsqlと同じコンソールで実行されます。
このコマンドは、作成されるプロセスの環境の環境変数TT_CONNSTRを設定します。

変数の値は、現在の接続の接続文字列です。

コマンドの終了ステータスを参照するには、_EXIT_STATUSを指定してdefineコマンドを使用します。

if-then-else

if-then-elseコマンド構成によって、ttIsqlセッションに条件分岐ロジックを実装できます。詳細は、「IF-THEN-ELSEコマンド構成の構文」を参照してください。

indexes [table_name_pattern]

現在のユーザーによって所有されており、入力パターンに一致する表で見つかった索引に関する説明が表示されます。名前パターンが指定されていない場合、パターンはデフォルトで%になります。
パススルーが有効になっている場合は、Oracle Database内の、パターンに一致する表の索引がリストされます。

allindexesコマンドを参照してください。

monitor [optional_monitor_column]

見やすくするためにSYS.MONITOR表の内容を書式化します。
optional_monitor_columnが指定された場合、その列のみが表示されます。

packages [object_name_pattern]

現在のユーザーによって所有されており、特定のパターンに一致するPL/SQLパッケージの名前が単一の列にリストされます。名前パターンが指定されていない場合、パターンはデフォルトで%になります。
パススルーが有効になっている場合は、Oracle Database内の、パターンに一致するPL/SQLパッケージがリストされます。

allpackagesコマンドを参照してください。

prepare [[connid.]command_id]SQL_Statement

指定したSQL文を準備します。command_id引数を指定しない場合は、command_idが自動的に割り当てられます。
command_id引数には0から255までの値を指定できます。connidを指定した場合、指定した接続IDに切り替えられます。connidには、英数字のみを使用することができ、大/小文字は区別されません。

print [variable]

指定したバインド変数の値が出力されます(変数を指定しない場合は、すべての変数の値が出力されます)。変数がREF CURSORの場合は、結果がフェッチされ、出力されます。

procedures [procedure_name_ pattern]

現在のユーザーによって所有されており、特定のパターンに一致するPL/SQLプロシージャの名前が単一の列にリストされます。名前パターンが指定されていない場合、パターンはデフォルトで%になります。
パススルーが有効になっている場合は、Oracle Database内の、パターンに一致するPL/SQLプロシージャがリストされます。

builtinsコマンドおよびallproceduresコマンド参照してください。

quit

ttIsqlを終了します。

remark msg

行のメッセージをコメントとして扱うことを指定します。行の最初にremまたはremarkがある場合、その行は読み込まれますが、無視されます。

repschemes [[scheme_owner_pattern.] scheme_name_pattern]

現在接続しているデータソースに定義されたレプリケーション・スキームの情報をレポートします。この情報は、レプリケーション・スキームに関連付けられたすべての要素を示します。
オプションの引数を省略した場合は、現在のデータソースに定義されたすべてのレプリケーション・スキームの情報がレポートされます。

retryconnect [0|1]

接続再試行機能を無効(0)または有効(1)にします。
接続再試行機能を有効にすると、最初は一時的な状況のために失敗した、データソースへの接続の試行は成功するまで繰り返されます。たとえば、接続の試行時に、データソース・リカバリが進行している場合は、接続再試行機能によって接続コマンドはリカバリ・プロセスが完了するまで接続を試行し続けます。

オプションの引数を省略した場合は、デフォルトによって接続再試行機能は有効にされます。

rollback

カレント・トランザクションをロールバックします。AutoCommitは無効にする必要があります。このコマンドによって、Oracle Database上でのTimesTen Cache操作が停止されることはありません(このような操作には、PassThrough文、フラッシング、手動ロード、手動リフレッシュ、同期ライトスルー、伝播および動的ロードが含まれます)。

rpad varname desiredlength paddingstring

RPADコマンドの動作は、SQL関数のRPAD()と似ていますが、次の制限があります。

- 必要な長さは、文字数ではなくバイト単位。

- 埋込み文字列は、文字列リテラルのエスケープ(Unicodeエスケープなど)用に拡張されない。

- 埋込み文字列は部分的にUnicode文字を使用することも、すべてUnicode文字にすることもできるが、マルチバイト・キャラクタまたはサロゲート・ペアの中央で埋込み文字列が分割される場合がある。

RPADコマンドで埋め込むことができるのは、文字ベースの変数(CHAR、VARCHAR)のみ。

run filename [arguments]|
start filename [arguments...]|

@@ filename [arguments...]|

@ filename [arguments...]

filenameからSQLコマンドを読み取って実行します。このコマンドは、最大5レベルまでネストできます。
@@コマンドは、ファイルを絶対パスで指定した場合にのみ@コマンドと同じになります。

@を相対パスとともに指定した場合、パスはttIsqlの起動ディレクトリに対する相対パスになります。@@を指定した場合、パスは現在実行中の入力ファイルに対する相対パスになります。このため、@@は、他のスクリプトのコールを必要とするスクリプトで使用する場合に有効です。ttIsqlの実行者がスクリプトをどのディレクトリから実行したかは重要ではありません。

argumentsについては、「コマンド文字列置換のパラメータの例」を参照してください。

savehistory
[-a | -f] outputfile

指定した出力ファイルに履歴バッファを書き込みます。
出力ファイルに保存されるのはコマンドのみで、パラメータ値は保存されません。このため、スクリプトを使用して出力ファイルから履歴を再生することはできません。

出力ファイルがすでに存在する場合、-aオプションまたは-fオプションを指定する必要があります。

-aを指定すると、指定した出力ファイルに履歴が追加されます。

-fを指定すると、指定した出力ファイルの内容が履歴で上書きされます。

clearhistoryコマンドおよびhistoryコマンド参照してください。

sequences [sequence_name_pattern]

現在のユーザーによって所有されており、特定のパターンに一致する順序の名前が単一の列にリストされます。名前パターンが指定されていない場合、パターンはデフォルトで%になります。
パススルーが有効になっている場合は、Oracle Database内の、パターンに一致する表の順序がリストされます。

allsequencesコマンドを参照してください。

set attribute [value]

指定したset/show属性を特定の値に設定します。
値を指定しない場合は、指定した属性の現在の値が表示されます。

指定できる属性の説明は、「属性の設定および表示」を参照してください。

setjoinorder tblNames [...]

オプティマイザに対して結合順序を指定します。AutoCommitは無効にする必要があります。

setuseindex index_name,correlation_name,
{0 | 1} [;...]

問合せオプティマイザの索引ヒントを設定します。

setvariable variable_name := value

スカラー・バインド変数の値または配列バインド変数の要素を設定します。たとえば、setvariable myvar := 'TimesTen';のように入力します(代入演算子(:=)の両端には空白が1つずつ必要です)。
詳細は、『Oracle TimesTen In-Memory Databaseオペレーション・ガイド』のバインド変数の宣言および設定に関する説明を参照してください。

show {all | attribute}

指定したset/show属性の値、またはすべての属性を表示します。
指定できる属性の説明は、「属性の設定および表示」を参照してください。

showjoinorder {0 | 1}

結合順序の保存を有効または無効にします。
0: 結合順序の保存を無効にします。

1: 結合順序の保存を有効にします。

SQLのSELECT文、UPDATE文、DELETE文またはMERGE文の後に結合順序を表示するには、ttoptshowjoinorder組込みプロシージャを明示的にコールします。

sleep [n]

実行をn秒間一時停止します。nを指定しない場合、実行は1秒間一時停止されます。

spool filename [option | OFF]

端末出力のコピーをファイルfilenameに書き込みます。
filenameに拡張子を指定しない場合、ファイル名には拡張子.lstが付けられます。使用可能なオプションは、次のとおりです。

CREATE: 新しいファイルを作成します。

APPEND: 出力を既存のファイルに追加します。

REPLACE(デフォルト): 既存のファイルを上書きします。

値OFFを指定した場合は、スプーリング動作が終了し、出力ファイルが閉じられます。

スプール・コマンドを指定したものの、スプールがすでに実行中である場合は、そのアクティブなスプールが閉じられ、新しいファイルが開かれます。

sqlcolumns [owner_name_pattern.]table_name_pattern

SQLColumnsへのODBCコールの結果を出力します。

sqlgetinfo infotype

SQLGetInfoへのODBCコールの結果を出力します。

sqlstatistics [[owner_name_pattern.]table_name_pattern]

SQLStatisticsへのODBCコールの結果を出力します。

sqltables[[owner_name_pattern.]table_name_pattern]

SQLTablesへのコールの結果を出力します。パターンは、任意の1文字を表すアンダースコア(_)、または0(ゼロ)文字以上の文字列を表すパーセント記号(%)を含む文字列です。

statsclear [[owner_name.]table_name]

指定した表(または表を指定しない場合はすべての表)の統計を消去します。

statsestimate [[owner_name.]table_name] {n rows | p percent}

指定した表(または表を指定しない場合はすべての表)の統計を見積もります。
システム表を更新する権限がある場合、空の表リストを指定して統計を見積もると、システム表の統計も更新されます。

statsupdate [[owner_name_pattern.] table_name_pattern]

指定した表(または表を指定しない場合はすべての表)の統計を更新します。
tblNameが空の文字列の場合、データベース内の現在のユーザーが所有するすべての表で統計が推定されます。

synonyms [[schema_pattern.] object_pattern]]

現在のユーザーによって所有されており、特定のパターンに一致するシノニムの名前が単一の列にリストされます。名前パターンが指定されていない場合、パターンはデフォルトで%になります。
Oracle Databaseへのパススルーが有効な場合は、Oracle Database内のパターンに一致する表のシノニムがリストされます。

allsynonymsコマンドを参照してください。

tables [table_name_pattern]]

現在のユーザーによって所有されており、特定のパターンに一致する表の名前が単一の列にリストされます。名前パターンが指定されていない場合、パターンはデフォルトで%になります。
Oracle Databaseへのパススルーが有効な場合は、Oracle Database内のパターンに一致する表がリストされます。

alltablesコマンドを参照してください。

tablesize [[owner_name_pattern.] table_name_pattern]]

パターンに一致する各表がALL_TAB_SIZESビューの内容にリストされます。
ttComputeTabSizes組込みプロシージャを参照してください。

tryglobalprocessing [0|1]

キャッシュ・グリッドの適切な問合せのグローバル処理を無効(0)または有効(1)にします。オプション引数を指定しない場合、グローバル処理が有効になります。show optprofileを使用してGlobalProcessingを問い合せます。
AutoCommitは無効にする必要があります。

undefine name

文字列置換別名の定義を取り消します。

unsetjoinorder

オプティマイザへの結合順序アドバイスを消去します。AutoCommitは無効にする必要があります。

unsetuseindex

問合せオプティマイザの索引ヒントを消去します。

use [conn_id]

現在の接続とそのIDのリストを表示します。connidを指定した場合は、特定の接続IDに切り替えられます。
初期接続の名前を使用するには、元の完全な接続名を指定するのではなく、conn_idにcon0を指定できます。con0接続を明示的に指定することはできません。初期接続が切断された場合、con0は接続noneを参照します。

useで接続IDを検出できなかった場合、現在の接続はnoneという名前の予約済接続に設定されます。

connectコマンドを参照してください。

variable [variable_name [data_type] [:= value]]
variableコマンドで複数の値を配列にバインドする構文は、次のとおりです。

variable array_name
'[' array_size ']'
data_type(n):=
'[' value1, ... valuex ']'

型が指定されていない場合、文で参照可能なバインド変数を宣言するか、または変数の定義を表示します。型は、(n)、NUMBER、CHAR(n)、NCHAR(n)、VARCHAR2(n)、NVARCHAR2(n)、BLOB、CLOB、NCLOBまたはREFCURSORのいずれかです。(n)のみが指定されている場合には、VARCHAR2 (n)としてみなされます。
1つの変数には1つの値を割り当て、データ型が配列型の場合には複数の値を割り当てます。setvariableコマンドを使用して、後で値を割り当てることもできます。

詳細は、『Oracle TimesTen In-Memory Databaseオペレーション・ガイド』のバインド変数の宣言および設定に関する説明を参照してください。

version

バージョン情報をレポートします。

views [table_name_pattern]

現在のユーザーによって所有されており、特定のパターンに一致するビューの名前が単一の列にリストされます。名前パターンが指定されていない場合、パターンはデフォルトで%になります。
Oracle Databaseへのパススルーが有効な場合は、Oracle Database内のパターンに一致するビューがリストされます。

allviewsコマンドを参照してください。

waitfor expected_result timeoutseconds sqlstatement

問合せで期待された結果が返されるまたはタイムアウトが起こるまで、指定された文を1秒に1度実行します。問合せは1列のみで正確に1列を返す必要があります。問合せでエラーが発生すると、ループは終了します。

waitforresult expected_result timeoutseconds searchrow searchcol sqlstatement

結果が1以上の列の場合を除き、waitforコマンドと同様です。また、結果は0行を返すこともあります。
問合せで期待された結果が返されるまたはタイムアウトが起こるまで、指定された文を1秒に1度実行します。searchrowおよびsearchcol引数は、行または列が考慮される順序を示す位置(1..N)を示します。searchrowまたはsearchcolで'*'を使用して、結果セットの任意の行または列が期待値を持つことを示します。waitforコマンドを参照してください。

whenever sqlerror

ttIsqlでエラーが発生したときの処理方法を指定します。詳細は、WHENEVER SQLERRORコマンドの構文を参照してください。

xlabookmarkdelete id

永続XLAブックマークを削除します。
削除するブックマークを指定しない場合は、現在のすべてのXLAブックマークの状態がレポートされます。

『Oracle TimesTen In-Memory Database C開発者ガイド』のttXlaDeleteBookmarkに関する説明も参照してください。

ADMIN権限またはオブジェクトの所有権が必要です。

IF-THEN-ELSE コマンド構成の構文

この項では、IF-THEN-ELSE構成の構文を示します。IF-THEN-ELSEコマンド構成の使用方法については、『Oracle TimesTen In-Memory Databaseオペレーション・ガイド』のIF-THEN-ELSEコマンド構成を使用した条件制御に関する説明を参照してください。

IF [NOT]
{ Literal1 | :BindVariable1 }
{ =  | IN }
{ Literal2 | :BindVariable2 | SelectStatement }
THEN "ThenCommands"
[ ELSE "ElseCommands" ] ;

ttIsqlのIF-THEN-ELSEコマンドには次のパラメータがあります。

パラメータ

説明

IF

IFコマンドはセミコロン(;)で終わる必要があります。
不適切な構文(BindVariablesが存在しない、SELECT文を実行できない、単一の列のみを返さない構文など)を指定すると、IFコマンドは失敗します。

NOT

NOTを使用すると、条件で期待される結果が逆になります。

Literal1, Literal2

比較対象になる値。

BindVariable1, BindVariable2

バインド変数はパラメータと同義です。:BindVariable1表記法を使用して、この構成にバインド変数を渡すことができます。変数の作成と設定には、variableまたはsetvariable ttIsqlコマンドを使用します。

= | IN

IN演算子はSelectStatementとともにのみ使用できます。IN演算子を使用すると、0行以上の行を返すことができます。等号(=)演算子は、単一の行を返す場合にのみ使用します。

SelectStatement

指定するSELECT文はSELECTで始まる必要があります。SELECT文で返すことができるのは、1つの列のみです。また、等号(=)演算子を指定すると、1つの行のみを返すことができます。
データベースに接続していない場合は、SelectStatementは使用できません。

ThenCommands, ElseCommands

THEN句またはELSE句のすべてのコマンドはセミコロンで区切る必要があり、二重引用符を含めることはできません。これらの句を使用すると、PL/SQLでは実行できないhostやrunなどのttIsqlコマンドを条件付きで実行できます。THEN句またはELSE句内では、CALL文を使用できます。PL/SQLブロックは使用できません。

IF-THEN-ELSE構成には次の制約があります。

- LOBデータ型の変数は比較できません。

- 値は、strcmpを使用して大/小文字を区別して比較されます。文字が埋め込まれた値は、その埋込みが原因でVARCHAR2と一致しない場合があります。

WHENEVER SQLERRORコマンドの構文

SQLエラーが発生したときの対処方法は、WHENEVER SQLERRORコマンドを実行して規定できます。WHENEVER SQLERRORコマンドの詳細と使用例は、『Oracle TimesTen In-Memory Databaseオペレーション・ガイド』のWHENEVER SQLERRORコマンドを使用したエラー・リカバリに関する説明を参照してください。

WHENEVER SQLERROR { ExitClause | ContinueClause | SUPPRESS |
SLEEP Number | ExecuteClause }

EXITを指定すると、エラーが発生した場合にttIsqlが常に終了します。ExitClauseは次のように設定します。

EXIT [ SUCCESS | FAILURE | WARNING | Number | :BindVariable ]
[ COMMIT | COMMIT ALL | ROLLBACK ]

CONTINUEを指定すると、エラーが発生した場合でもttIsqlによって次のコマンドが続行されます。ContinueClauseは次のように設定します。

CONTINUE [ COMMIT | COMMIT ALL | ROLLBACK | NONE ]

処理を継続する前に指定のコマンドを実行します。ExecuteClauseは次のように設定します。

EXECUTE "Cmd1;Cmd2;...;"

WHENEVER SQLERRORコマンドには次のオプションがあります。

- EXIT: エラーが発生した場合は常にttIsqlが終了します。ttIsqlの終了前に実行する処理を、次のいずれかで指定します。SUCCESSはEXITのデフォルト・オプションです。

- SUCCESS、FAILUREまたはWARNING: ttIsqlがすべてのSQLエラーを終了した後で、SUCCESS(値0)、FAILURE(値1)またはWARNING(値2)をオペレーティング・システムに返します。

- Number: リターン・コードとしてオペレーティング・システムに返す、0から255の数値を指定します。ttIsqlが終了した場合は、適切なオペレーティング・システム・コマンドでエラーのリターン・コードを取得できます。たとえば、Cシェル(csh)でecho $statusを使用するか、Bourneシェル(sh)でecho $?を使用して、リターン・コードを表示できます。
リターン・コードはバッチ・コマンド・ファイル内で取得および処理できるため、想定外のイベントをプログラムで検出し、そのイベントに対応することができます。

- :BindVariable: variableコマンドによってttIsqlで以前に作成した値をバインド変数に返します。Numberオプションと同様に、エラーの発生時に変数の値をオペレーティング・システムに返します。

注意:
WHENEVER SQLERRORコマンド内で使用するバインド変数は、LOB、REFCURSOR、または配列関連のデータ型として定義することはできません。

また、ttIsqlの終了前に、すべての変更をコミットするか、またはロールバックするかを指定できます。

- COMMIT: 終了前にCOMMITを実行し、現在の接続で行われた変更のみを保存します。その他の接続は通常の切断処理で終了し、コミット前のすべての変更はロールバックされます。

- COMMIT ALL: 終了前にCOMMITを実行し、すべての接続で行われた変更を保存します。

- ROLLBACK: 終了前にROLLBACKを実行し、(デフォルトでは)現在の接続と他のすべての接続で行われた変更を破棄します。その他の接続は通常の切断処理で終了し、コミット前のすべての変更は自動的にロールバックされます。

- CONTINUE: エラーが発生しても終了しません。SQLエラーが表示されますが、そのエラーによってttIsqlが終了することはありません。次のオプションでは、後続のttIsqlコマンドを実行する前の処理を指定できます。

- NONE: これがデフォルトです。処理を継続する前のアクションはありません。

- COMMIT: 処理を継続する前にCOMMITを実行し、現在の接続で行われた変更を保存します。

- COMMIT ALL: 処理を継続する前にCOMMITを実行し、すべての接続で行われた変更を保存します。

- ROLLBACK: 処理を継続する前にROLLBACKを実行し、(デフォルトでは)現在の接続と他のすべての接続で行われた変更を破棄します。その他の接続は通常の切断処理で終了し、コミット前のすべての変更は自動的にロールバックされます。

- SUPPRESS: すべてのエラー・メッセージを非表示にして、処理を継続します。

- SLEEP: 処理を継続する前に、指定した時間(秒)だけスリープ状態になります。

- EXECUTE: 処理を継続する前に、指定したコマンドを実行します。複数のコマンドは、それぞれセミコロン(;)で区切ります。その他のエラーでトリガーされるコマンドがある場合は、それらのエラーが別のアクションを引き起こす可能性があり、場合によってはループ状態に陥ることもあります。

属性の設定および表示

ttIsqlの「コマンド」のリストも参照してください。一部のコマンドは、setコマンドの属性として使用されます。その場合、それらの属性はsetコマンドがあってもなくても使用できます。

ブール属性では、ONおよびOFFまたは1および0の値を使用できます。

ttIsqlのsetコマンドには次の属性があります。

属性

説明

all

showコマンドのみを使用します。すべてのttIsqlコマンドの設定を表示します。

autocommit [1|0]

AutoCommitを無効および有効にします。引数を指定しない場合は、現在の設定が表示されます。

autovariables [1|0]

autovariablesをオフまたはオンにします。最後にフェッチした行の各列と同じ名前を使用して自動バインド変数が作成されます。自動バインド変数は他のバインド変数と同様に使用できます。詳細は、『Oracle TimesTen In-Memory Databaseオペレーション・ガイド』の取得された列のバインド変数の自動作成に関する説明を参照してください。

columnlabels [0 | 1]

columnlabels機能の無効(0)と有効(1)を切り替えます。
引数を指定しない場合は、columnlabelsの現在の値が表示されます。

データ・ソースに接続した後のcolumnlabelsの初期値は無効(0)です。

値が有効(1)の場合は、SQLの結果の前に列名が表示されます。

setコマンドを指定しないでこの属性を有効にすることもできます。

connstr

SQLDriverConnectコールによって、ドライバから返された接続文字列を出力します。これは、ttIsqlによるデータベースへの接続が成功した場合に出力される文字列と同じ文字列です。

define [&|c|on|off]

置換変数の接頭辞に使用する文字をcに設定します。
ONまたはOFFによって、ttIsqlがコマンドをスキャンして置換変数を検索し、その値に置換するかどうかを指定します。ONを指定すると、cの値がデフォルトの&に戻ります。(最近使用した文字には変更しません。)

ttIsqlのデフォルト値はOFF(変数の置換なし)です。デフォルトについては、「変数および出力を使用したパラメータの例」を参照してください。

dynamicloadenable [on|off]

Oracle DatabaseからTimesTenの動的キャッシュ・グループへのデータの動的ロードを有効または無効にします。デフォルトでは、Oracle Databaseからのデータの動的ロードが有効になっています。

echo [on | off]

setコマンドで使用した場合、run、@または@@スクリプトに指定されているコマンドを実行すると、そのコマンドが端末に出力されます。
offの場合、コマンドの出力は出力されますが、コマンド自体は出力されません。

editline [0 | 1]

editline機能の無効と有効を切り替えます。デフォルトでは、editlineは有効です。
editlineが無効になっている場合は、バックスペース文字によってすべての文字を削除できますが、editlineのその他の機能は使用できません。

err | error |errors [.objecttype[schema.] name]

showコマンドを使用して、指定したPL/SQLオブジェクトに関するエラー情報を表示します。オブジェクト・タイプまたはオブジェクト名を指定しない場合は、ttIsqlは最後に作成しようとしたPL/SQLオブジェクトとみなし、そのオブジェクトのエラーが取得されます。指定のオブジェクトに関連付けられたエラーが見つからないか、または以前のPL/SQL DDLが存在しない場合は、ttIsqlによって「No errors」と表示されます。

feedback [on | off] rows

文を実行した後のステータス・メッセージの表示を制御します。
rowsが指定されているときに、指定された以上の行数に文が影響を与えた場合は、feedbackによって、影響を受ける行数が示されます。影響を受けた行数が指定のしきい値よりも少ない場合、行数は出力されません。feedbackは、表、ビュー、順序、マテリアライズド・ビュー、索引には使用できません。PL/SQLオブジェクトに対して使用可能です。

isolation [{READ_COMMITTED | 1}| {SERIALIZABLE | 0}]

分離レベルを設定します。引数を指定しない場合は、現在の値が表示されます。
setコマンドを指定しないでこの属性を有効にすることもできます。

loboffset n

ttIsqlがLOBの結果値を出力するときに、その開始点として適用するオフセットを指定します。たとえば、LOBの値がABCEDFGで、オフセットが4の場合、ttIsqlは最初の3バイトをスキップしてDEFGを出力します。
この動作はSQL*PlusのLOBOFFSETと同じです。

long n

フェッチ時や出力時に表示するCLOB/BLOBデータの最大文字数、またはBLOBデータの最大バイト数をレポートまたは制御します。
デフォルト値は80です。

このコマンド設定は、セッション内のすべての接続に対して有効です。

longchunksize n

ttIsqlでLOBデータを取得するときに使用するチャンク・サイズを指定します。

multipleconnections [1 | ON] mc [1 | ON]

複数の接続の処理をレポートまたは可能にします。デフォルトでは、ttIsqlではユーザーは1つずつ接続をオープンすることができます。
引数1またはONが指定されている場合、プロンプトは現在の接続を含むように変更され、すべてのmultipleconnections機能が有効になります。

値が指定されていない場合、コマンドにはmultipleconnections設定の値が表示されます。

setコマンドを指定しないでこの属性を有効にすることもできます。

ncharencoding [encoding]

NCHARの出力に使用する文字エンコードを指定します。有効な値はLOCALEまたはASCIIです。
LOCALEは、出力形式をロケール・ベースで設定します。

値を指定しない場合は、TimesTenではシステム固有の言語文字が使用されます。

setコマンドを指定しないでこの属性を有効にすることもできます。

optfirstrow [1|0]

First Rowオプティマイザを有効または無効にします。
オプション引数を指定しない場合、First Rowオプティマイザが有効になります。

setコマンドを指定しないでこの属性を有効にすることもできます。

optprofile

現在のオプティマイザ・フラグの設定と結合順序を出力します。
この属性はsetコマンドで使用できません。

passthrough [0|1|2|3|4|5]

現在のトランザクションにTimesTen Cacheのパススルー・レベルを設定します。このコマンドを実行するにはAutoCommitを無効にする必要があるため、パススルー・レベルを設定する場合、ttIsqlは一時的にAutoCommitを無効にします。
0: SQL文はTimesTenに対してのみ実行されます。

1: INSERT、DELETE、UPDATEおよびDDL以外の文がTimesTenで構文エラーを生成する場合、またはこれらの文で参照されている1つ以上の表がTimesTenに存在しない場合、INSERT、DELETE、UPDATEおよびDDL以外の文が渡されます。対象の表がTimesTenで見つからない場合、すべてのINSERT、DELETEおよびUPDATE文が渡されます。DDL文は渡されません。

2: 1と同じ動作に加え、READONLYのキャッシュ・グループ表に対して実行されたすべてのINSERT、UPDATEおよびDELETE文が渡されます。

3 : COMMITおよびROLLBACK以外のすべてのSQL文と、オプティマイザ・フラグを設定または取得するTimesTen組込みプロシージャが渡されます。COMMITおよびROLLBACKは、TimesTenおよびOracle Databaseの両方で実行されます。

4: 動的ロードを使用できないグローバル・キャッシュ・グループ表に対するすべてのSELECT文が、Oracle Databaseに対して実行されます。

5: 動的ロードを使用できないグローバル・キャッシュ・グループ表に対するすべてのSELECT文が、Oracle Databaseに対して実行されます。SELECT文は、グローバル・キャッシュ・グループに対するすべてのコミット済変更がOracle Databaseに伝播されるまで実行されません。

オプション引数を指定しない場合は、現在の設定が表示されます。

トランザクションが完了すると、パススルー値は、接続文字列またはDSNに定義されている値にリセットされます。いずれの値も指定されていなかった場合は、デフォルト設定にリセットされます。

setコマンドを指定しないでこの属性を有効にすることもできます。

注意: 一部のOracleオブジェクトは、ttIsqlで記述できない場合があります。

prefetchcount [prefetch_count_size]

現在の接続のプリフェッチ・カウント・サイズを設定します。オプション引数を省略した場合は、現在のプリフェッチ・カウント・サイズがレポートされます。プリフェッチ・カウント・サイズを設定した場合は、結果セットのフェッチ速度を改善できます。prefetch_count_size引数には0から128までの整数を指定できます。
プリフェッチ数を0 (ゼロ)に設定すると、TimesTenはデフォルトのプリフェッチ数を使用します。デフォルトのプリフェッチの値は、分離レベル固有です。コミット読取り分離モードでは、デフォルト値は5です。シリアライズ可能分離モードでは、デフォルト値は128です。

setコマンドを指定しないでこの属性を有効にすることもできます。

prompt [string]

Command>プロンプトを指定した文字列に置き換えます。
プロンプトに空白を指定する場合は、文字列を引用符で囲む必要があります。先行する引用符および後続の引用符は削除されます。

プロンプトには、文字列書式指定子(%c)を埋め込むことができます。%cは、現在の接続名に変換されます。

querythreshold [seconds]

showコマンドで使用した場合は、QueryThreshold初期接続属性の値が表示されます。
setコマンドで使用した場合は、接続文字列またはodbc.iniファイルに設定されたQueryThreshold初期接続属性の値が変更されます。

問合せの最大実行秒数を示す値を秒単位で指定します。この秒数を超えると、警告がサポート・ログに書き込まれるか、またはSNMPトラップがスローされます。

rowdelimiters [0|off] | [ {1|on} [begin [ end]]]

結果セットの行デリミタを制御します。onの場合、ユーザー問合せはbeginおよびendが指定されないかぎり、行が<および>で区切られます。すべての結果セットがこの制御の影響を受けるわけではありません。
デフォルトはonです。

serveroutput [on | off]

setコマンドでonに設定して使用した場合は、SQL文を実行するたびに、出力可能な情報がすべて表示されます。出力を保存するようにPL/SQL DBMS_OUTPUTパッケージを設定して、このコマンドで出力を取得できるようにしている場合は、この出力をI/Oのデバッグに使用できます。
このコマンドを使用するとパフォーマンスが低下することがあるため、デフォルトではoffになっています(サーバー出力は表示されません)。serveroutputをonに設定した場合は、TimesTenで使用されるバッファのサイズに制限がありません。

DBMS_OUTPUT.ENABLEは接続単位であるため、set serveroutput onは現在の接続にのみ影響を及ぼします。

showcurrenttime [1|true|on] | [0|false|off]

現在のウォール・クロック時間の出力を有効または無効にします。

showplan [0 | 1]

このトランザクションの選択/更新/削除の計画の表示を有効(1)または無効(0)にします。引数を省略した場合、計画の表示は有効になります。AutoCommitは無効にする必要があります。
setコマンドを指定しないでこの属性を有効にすることもできます。

sqlquerytimeout [seconds]

アプリケーションでの後続のコールに戻る前にSQL文の実行を待機する秒数を指定します。
時間を指定しなかった場合または0 (ゼロ)秒を指定した場合は、現在のタイムアウト値が表示されます。

secondsの値は、0以上である必要があります。この属性によって、Oracle Database上でのTimesTen Cache操作が停止されることはありません(このような操作には、PassThrough文、フラッシング、手動ロード、手動リフレッシュ、同期ライトスルー、伝播および透過的ロードが含まれます)。

setコマンドを指定しないでこの属性を有効にすることもできます。

timing [1|0]

問合せタイミングの出力を有効または無効にします。
setコマンドを指定しないでこの属性を有効にすることもできます。

tryhash [1|0]

オプティマイザによるトランザクション・レベルでのハッシュ索引の使用を有効または無効にします。AutoCommitは無効にする必要があります。
setコマンドを指定しないでこの属性を有効にすることもできます。

trymaterialize [1|0]

オプティマイザによるトランザクション・レベルでの実体化を有効または無効にします。AutoCommitは無効にする必要があります。
setコマンドを指定しないでこの属性を有効にすることもできます。

trymergejoin [1|0]

オプティマイザによるトランザクション・レベルでのマージ結合の使用を有効または無効にします。AutoCommitは無効にする必要があります。
setコマンドを指定しないでこの属性を有効にすることもできます。

trynestedloopjoin [1|0]

オプティマイザによるトランザクション・レベルでのネステッド・ループ結合の使用を有効または無効にします。AutoCommitは無効にする必要があります。
setコマンドを指定しないでこの属性を有効にすることもできます。

tryrowid [1|0]

オプティマイザによるトランザクション・レベルでのrowIDスキャン・ヒントを有効または無効にします。

tryrowlocks [1|0]

オプティマイザによるトランザクション・レベルでの行レベル・ロックの使用を有効または無効にします。AutoCommitは無効にする必要があります。
setコマンドを指定しないでこの属性を有効にすることもできます。

tryserial [1|0]

オプティマイザによるトランザクション・レベルでのシリアル・スキャンの使用を有効または無効にします。AutoCommitは無効にする必要があります。
setコマンドを指定しないでこの属性を有効にすることもできます。

trytmphash [1|0]

オプティマイザによる一時的なハッシュ索引の使用を有効または無効にします。AutoCommitは無効にする必要があります。
setコマンドを指定しないでこの属性を有効にすることもできます。

trytbllocks [1|0]

オプティマイザによるトランザクション・レベルでの表レベル・ロックの使用を有効または無効にします。AutoCommitは無効にする必要があります。
setコマンドを指定しないでこの属性を設定することもできます。

trytmptable [1|0]

オプティマイザによるトランザクション・レベルでの一時表の使用を有効または無効にします。AutoCommitは無効にする必要があります。
setコマンドを指定しないでこの属性を有効にすることもできます。

trytmprange [1|0]

オプティマイザによるトランザクション・レベルでの一時範囲索引の使用を有効または無効にします。AutoCommitは無効にする必要があります。
setコマンドを指定しないでこの属性を有効にすることもできます。

tryrange [1|0]

オプティマイザによるトランザクション・レベルでの範囲索引の使用を有効または無効にします。AutoCommitは無効にする必要があります。
setコマンドを指定しないでこの属性を有効にすることもできます。

verbosity [level]

冗長レベルを変更します。冗長レベル引数は0、1、2、3または4の整数値です。オプションの引数を省略すると、現在の冗長レベルがレポートされます。
setコマンドを指定しないでこの属性を有効にすることもできます。

vertical [{0 | off} | {1 | on} | statement]

vertical設定の現在の値を設定または表示します。デフォルト値は0(無効)です。
statementを指定した場合、コマンドでは指定された文に対して一時的にverticalを有効にします。この形式は、verticalフラグが無効になっている場合にのみ有効です。

vertical設定では、結果セットの表示形式が制御されます。設定した場合、結果セットは、各列が個別の行にあり列ラベルとともに表示される垂直形式で表示されます。

setコマンドを指定しないでこの属性を有効にすることもできます。

コメント構文

コメント・マーカーのタイプは、次のとおりです。

# [comment_text]
-- [comment_text]
/* [comment_text] */

Cスタイルのコメント(/* [comment_text] */)は、複数の行にまたがることができます。

コメントの区切りに次の文字が使用されている場合

#

および

-

この場合は、複数の行にまたがることができません。行の処理中にコメント・マーカーが検出されると、ttIsqlは行の残りを無視します。

'--'(行の先頭)はSQLコメントとみなされます。その行はコメントとみなされ、行のいずれの部分もSQL文の処理に含まれません。「--+」で始まる行は、SQL文のセグメントとして解釈されます。

コメント・マーカーは行の途中で使用できます。

例:

monitor; /*this is a comment after a ttIsql command*/

コマンド履歴

ttIsqlはcshに類似したコマンド履歴を実現します。

コマンドの使用法: history [-r] [num_commands]

説明: 以前に実行されたコマンドを表示します。num_commandsパラメータは、表示するコマンド数を指定します。-rパラメータを指定した場合、コマンドは逆の順序で表示されます。

コマンドの使用法: ![command_id|command_string| !]

説明: 履歴リスト内のコマンドを実行します。command_id引数を指定した場合は、このIDと関連付けられた履歴リストのコマンドが再実行されます。command_string引数を指定した場合は、command_stringで始まる履歴リスト内の最新のコマンドが再実行されます。!引数を指定した場合は、実行された最新のコマンドが再実行されます。

例: !!;または!10;または!con;

clearhistory、history、savehistoryコマンドも参照してください。

コマンド・ショートカット

ttIsqlでは、デフォルトでコマンド入力時のキーストロークのショートカットがサポートされています。この機能を無効にするには、次のように入力します。

Command> set editline=0;

ttIsqlのキーストロークのショートカットは次のとおりです。

キーストローク

操作

[←]

挿入点を左に移動(後退)します。

[→]

挿入点を右に移動(前進)します。

[↑]

表示されているコマンドの1つ前のコマンドにスクロールします。カーソルは行末に移動します。

[↑]<RETURN>

表示されているPL/SQLブロックの1つ前のPL/SQLブロックにスクロールします。

[↓]

最新のコマンド履歴項目までスクロールします。カーソルは行末に移動します。

[↓]<RETURN>

表示されているPL/SQLブロックの1つ後のPL/SQLブロックにスクロールします。

[Ctrl] + [A]

挿入点を行の先頭まで移動します。

[Ctrl] + [E]

挿入点を行末まで移動します。

[Ctrl] + [K]

コマンドライン上の現在の位置から行末までの文字を保存して削除(Kill)します。

[Ctrl] + [Y]

以前保存した文字をリストア(Yank)して現在の挿入点に挿入します。

[Ctrl] + [F]

カーソルを右に1文字移動します。([→]を参照。)

[Ctrl] + [B]

カーソルを左に1文字移動します。([←]を参照。)

[Ctrl] + [P]

前の履歴に移動します。([↑]を参照。)

[Ctrl] + [N]

次の履歴に移動します。([↓]を参照。)

パラメータ

動的パラメータによって、個別の行で各パラメータへの入力が求められます。パラメータの値は、SQLで1つのリテラルを指定するのと同じ方法で指定します。

SQL_TIMESTAMP列は、動的パラメータを使用して追加できます。(たとえば、「1998-09-08 12:1212」のような値)。

パラメータ値はセミコロン文字で終了する必要があります。

指定可能な値の種類は次のとおりです。

- 数値リテラル。例: 1234.5

- 一重引用符で囲まれた時刻リテラル、日付リテラルまたはタイムスタンプ・リテラル。次に例を示します。

'12:30:00''2000-10-29''2000-10-29 12:30:00''2000-10-29 12:30:00.123456'

- 先頭が「N」で始まる、一重引用符で囲まれたUnicode文字列リテラル。例: N'abc'

- NULL値。例: NULL

- パラメータ入力処理が停止されることを示す「*」文字。例: *

- パラメータ入力ヘルプ情報を出力する「?」文字。例: ?

コマンド文字列置換のパラメータの例

Command> select * from dual where :a > 100 and :b < 100;
Type '?' for help on entering parameter values.
Type '*' to end prompting and abort the command.
Type '-' to leave the parameter unbound.
Type '/;' to leave the remaining parameters unbound and execute the command.

Enter Parameter 1 'A' (NUMBER) > 110
Enter Parameter 2 'B' (NUMBER) > 99
< X >
1 row found.
Command> var a number;
Command> exec :a := 110;

PL/SQL procedure successfully completed.

Command> print a
A                    : 110
Command> var b number;
Command> exec :b := 99;

PL/SQL procedure successfully completed.

Command> select * from dual where :a > 100 and :b < 100;
< X >
1 row found.
Command> print
A                    : 110
B                    : 99
Command> select * from dual where :a > 100 and :b < 100 and :c > 0;
Enter Parameter 3 'C' (NUMBER) > 1
< X >
1 row found.
Command>

デフォルト・オプション

環境変数TTISQLをエクスポートすることによって、デフォルトのコマンドライン・オプションを設定できます。TTISQL環境変数の値は、TTISQLコマンドラインと同じ構文要件を備えた文字列です。TTISQL環境変数とコマンドラインに同じオプションが存在している場合は、コマンドラインに指定されているオプションが常に優先されます。

例

ttIsql.inpからコマンドを実行します。

ttIsql -f ttIsql.inp

すべての出力を有効にします。DSN RunDataに接続し、データベースが存在していない場合は作成します。

ttIsql -v 4 -connStr "DSN=RunData;AutoCreate=1"

対話形式のコマンドで出力します。

ttIsql -helpcmds

ヘルプ・テキスト全体を出力します。

ttIsql -helpfull

すべてのttIsql set/show属性の設定を表示します。

Command> show all;
Connection independent attribute values:

autoprint = 0 (OFF)
columnlabels = 0 (OFF)
define = 0 (OFF)
echo 1 (ON)
FEEDBACK ON
multipleconnections =0 (OFF)
ncharencoding = LOCALE (US7ASCII)
prompt = 'COMMAND>'
timing = 0 (OFF)
verbosity = 2
vertrical = 0 (OFF)

Connection specific attribute values:

autocommit = 1 (ON)
Client timeout = 0
Connection String DSN=repdb1_1121;UID=timesten; DataStore=/DS/repdb1_1121;
DatabaseCharacterSet=AL32UTF8; ConnectionCharacterSet=US7ASCII;
DRIVER=/opt/TimesTen/tt1122/lib/libtten.so; PermSize=20;TempSize=20;TypeMode=1;
No errors.
isolation = READ_COMMITTED
Prefetch count = 5
Query threshold = 0 seconds (no threshold)
Query timeout = 0 seconds (no timeout)
serveroutput OFF

Current Optimizer Settings:
Scan: 1
Hash: 1
Range: 1
TmpHash: 1
TmpTable: 1
NestedLoop: 1
MergeJoin: 1
GenPlan: 0
TblLock: 1
RowLock: 1
Rowid: 1
FirstRow: 1
IndexedOr: 1
PassThrough: 0
BranchAndBound: 1
ForceCompile: 0
CrViewSemCheck: 1
ShowJoinOrder: 0
CrViewSemCheck: 1
UserBoyerMooreStringSearch: 0
DynamicLoadEnable: 1
DynamicLoadErrorMode: 0
NoRemRowIdOpt: 0

Current Join Order:
<>

Command

SQL文を準備して実行します。

ttIsql (c) 1996-2011, TimesTen, Inc. All rights reserved.
ttIsql -connStr "DSN=RunData"
Type ? or "help" for help, type "exit" to quit ttIsql.
(Default setting AutoCommit=1)
Command> prepare 1 SELECT * FROM my_table;
Command> exec 1;
Command> fetchall;

verticalコマンドの例:

Command> call ttlogholds;
< 0, 265352, Checkpoint , DS.ds0 >
< 0, 265408, Checkpoint , DS.ds1 >
2 rows found.
Command> vertical call ttlogholds;

HOLDLFN:       0

HOLDLFO:       265352
TYPE:          Checkpoint
DESCRIPTION:   DS.ds0
HOLDLFN:       0

HOLDLFO:       265408
TYPE:          Checkpoint
DESCRIPTION:   DS.ds1
2 rows found.

Command>

新しいユーザーを作成するには、内部ユーザーのパスワード名を一重引用符で囲んで入力します。

ttIsql -connStr "DSN=RunData"
ttIsql (c) 1996-2000, TimesTen, Inc. All rights reserved.
Type ? or "help" for help, type "exit" to quit ttIsql.
(Default setting AutoCommit=1)
Command> CREATE USER terry IDENDTIFIED BY `secret';

mybookmarkというXLAブックマークを削除するには、次のように入力します。

ttIsql -connStr "DSN=RunData"
ttIsql (c) 1996-2000, TimesTen, Inc. All rights reserved.
Type ? or "help" for help, type "exit" to quit ttIsql. (Default setting
AutoCommit=1)
Command> xlabookmarkdelete;
XLA Bookmark: mybookmark
Read Log File:  0
Read Offset:    268288
Purge Log File: 0
Purge Offset:   268288
PID:            2004
In Use:         No
1 bookmark found.

Command> xlabookmarkdelete mybookmark;

Command> xlabookmarkdelete;

0 bookmarks found.

結果「X」が返されるまで、または問合せが10秒でタイムアウトになるまでSELECT問合せを実行するには、次のように入力します。

ttIsql -connStr "DSN=RunData"
ttIsql (c) 1996-2000, TimesTen, Inc. All rights reserved.
Type ? or "help" for help, type "exit" to quit ttIsql. (Default setting
AutoCommit=1)
Command> waitfor X 10 select * from dual;
Command>

XLAブックマークの管理の例

xlabookmarkdeleteコマンドを使用して、現在のXLAブックマークのステータスの確認およびブックマークの削除の両方を実行できます。このコマンドには、XLA権限またはオブジェクト所有権が必要です。

たとえば、XLAアプリケーションxlaSimpleを実行している場合は、次のように入力してブックマークのステータスを確認できます。

Command> xlabookmarkdelete;

XLA Bookmark: xlaSimple
Read Log File: 0
Read Offset: 630000
Purge Log File: 0
Purge Offset: 629960
PID: 2808
In Use: No
1 bookmark found.

ブックマークを削除するには、次のように入力します。

Command> xlabookmarkdelete xlaSimple;
Command>

変数および出力を使用したパラメータの例

ttIsqlの置換は、SQL*Plusの置換をモデルにしています。置換機能を有効にするには、set define onまたはset define substitution_charを使用します。ユーザーがonを指定した場合の置換文字は&です。無効にするには、set define offを使用します。デフォルトでは、置換はoffになっています。デフォルトがoffになっているのは、置換文字に&を選択するとTimesTenがビットAND演算子として使用するアンパサンドと競合するためです。有効にすると、置換文字に続く英数字の識別子はその識別子に割り当てられている値に置き換えられます。無効にすると、このような展開は実行されません。置換がoffのときでも、新しい定義を指定できます。ttIsqlに事前定義されている定義をリストするには、defineコマンドを使用します。

Command> show define
define = 0 (OFF)
Command> define
DEFINE            _PID = "9042" (CHAR)
DEFINE      _O_VERSION = "TimesTen Release 11.2.1.0.0" (CHAR)
Command> select '&_O_VERSION' from dual;
< &_O_VERSION >
1 row found.
Command> set define on
Command> SELECT '&_O_VERSION' FROM DUAL;
< TimesTen Release 11.2.1.0.0 >
1 row found.

値を定義しない場合は、ttIsqlによって値の入力が求められます。このとき、識別子の前に指定される置換文字が1つのみの場合、識別子は1つの文の存続期間のみ定義済になります。置換文字を2つ使用し、値の入力が求められた場合は、識別子を明示的に定義したかのように機能します。

Command> SELECT '&a' FROM DUAL;
Enter value for a> hi
< hi >
1 row found.
Command> define a
symbol a is UNDEFINED
The command failed.
Command> SELECT '&&a' FROM DUAL;
Enter value for a> hi there
< hi there >
1 row found.
Command> define a
DEFINE               a = "hi there" (CHAR)

追加の定義を作成するには、defineコマンドを使用します。

Command> define tblname = sys.dual
Command> define tblname
DEFINE         tblname = "sys.dual" (CHAR)
Command> select * from &tblname;
< X >
1 row found.

runコマンドの引数は、次のスクリプトに示すように、引数をrunコマンドまたは@(および@@)コマンドに追加すると、'&1'、'&2'などに対して自動的に定義されます。

CREATE TABLE &1 ( a INT PRIMARY KEY, b CHAR(10) );
INSERT INTO &1 VALUES (1, '&2');
INSERT INTO &1 VALUES (2, '&3');SELECT * FROM &1;

次のようにスクリプトを使用します。

Command> SET DEFINE ON
Command> @POPULATE mytable Joe Bob;

CREATE TABLE &1 ( a INT PRIMARY KEY, b CHAR(10) );
INSERT INTO &1 VALUES (1, '&2');
1 row inserted.

INSERT INTO &1 VALUES (2, '&3');
1 row inserted.

SELECT * FROM &1;
< 1, Joe        >
< 2, Bob        >
2 rows found.
Command>

この例では、variableコマンドを使用しています。このコマンドは、employee表から従業員を削除します。empidおよびnameをemployee_idおよびlast_nameと同じデータ型の変数として宣言します。行を削除し、employee_idおよびlast_nameを変数内に戻します。正しい行が削除されたことを確認します。

Command> VARIABLE empid NUMBER(6) NOT NULL;
Command> VARIABLE name VARCHAR2(25) INLINE NOT NULL;
Command> DELETE FROM employees WHERE last_name='Ernst'
> RETURNING employee_id, last_name INTO :empid,:name;
1 row deleted.
Command> PRINT empid name;
EMPID                : 104
NAME                 : Ernst

注意

ttIsqlユーティリティは汎用のREF CURSOR変数のみをサポートし、特定のREF CURSORタイプはサポートしません。

複数のttIsqlコマンドは、セミコロンで区切られた行ごとに使用できます。名前付き識別子でその名前に#文字が含まれる場合、単一の行に複数のSQL文を配置するには、名前付き識別子を含む文を引用符で囲む必要があります。次に例を示します。

% ttisql -e 'drop table "t#" ; create table "t#" ( c1 int );' -dsn mydb

ttIsqlユーティリティのコマンドラインでは、無名ブロックなど複数行にわたるPL/SQL文を使用できます(この場合は「/」のみの行で終了します)。次に例を示します。

Command> set serveroutput on
Command> BEGIN
> dbms_ouput.put_line ('Hi There');
> END;
>/
Hi There

PL/SQL block successfully executed.

Command>

UTF-8の場合、NCHAR値はUTF-8エンコードに変換されてから出力されます。

ASCIIの場合、ASCII文字に対応するNCHAR値はASCIIとして出力されます。ASCII以外のNCHAR値では、エスケープされたUnicode書式が使用されます。次に例を示します。

U+3042 HIRAGANA LETTER A

これは、次のように出力されます。

Command> SELECT c1 FROM t1;
< a\u3042 >

NCHARパラメータは、先頭がASCII Nで始まる一重引用符で囲まれたリテラルとして入力する必要があります。

Command> prepare SELECT * FROM t1 WHERE c1 = ?;
Command> exec;

パラメータ値の入力についてヘルプを表示するには、?;を入力してください。パラメータ入力処理を終了するには、*;を入力します。

Enter Parameter 1> N'XY';

Windowsでは、すべてのTimesTen Data ManagerおよびクライアントDSNで、このユーティリティがサポートされています。

ttMigrate

説明

次の操作のいずれかを実行します。

- 移行オブジェクトをTimesTenデータベースからバイナリ・データファイルに保存します。

- 移行オブジェクトをバイナリ・データファイルからTimesTenデータベースにリストアします。

- このユーティリティで作成されたバイナリ・データファイルの内容を調査します。

移行オブジェクトには次のものがあります。

- 表

- キャッシュ・グループ定義

- ビューおよびマテリアライズド・ビュー

- マテリアライズド・ビュー・ログ定義

- 順序

- レプリケーション・スキーム

データベース・チェックポイントおよびログ・ファイルにはメジャー・リリース間で互換性がないため、TimesTenのメジャー・リリースをアップグレードするときはttMigrateユーティリティを使用します。例については、『Oracle TimesTen In-Memory Databaseインストレーション・ガイド』を参照してください。

以前のリリースからリリース11.2.1にデータベースを移行した場合、TimesTenはユーザーおよびユーザー権限を移行しません。データベースをリリース11.2.1間で移行した場合、またはリリース11.2.1より後のリリースに移行した場合は、TimesTenによってユーザーおよびユーザー権限が移行されます。

このユーティリティで作成されるバイナリ・ファイルはプラットフォーム依存です。たとえば、Windowsで生成されたバイナリ・ファイルはWindowsにリストアする必要があります。クライアント/サーバー・モードでは、プラットフォーム間でデータをコピーするには、ttMigrateCSユーティリティ(UNIXのみ)を使用します。

このユーティリティで作成されるバイナリ・ファイルはプラットフォーム固有です。たとえば、Windows 64ビットで生成されたバイナリ・ファイルはWindows 64ビットにリストアする必要があります。プラットフォーム間またはビット・レベル間でデータをコピーするには、ttMigrateをttMigrateCSクライアント/サーバー・バージョンとともに使用します(またはWindowsでの同等の処理)。Windowsシステムでは、ttMigrateを使用して同等の処理を実行し、定義済TimesTenクライアントDSNを通じてターゲット・システムからソース・システムに接続します。

UNIXでは、このユーティリティはTimesTen Data Manager DSNで使用できます。TimesTenクライアントDSNでは、ttMigrateCSユーティリティを使用します。

必要な権限

このユーティリティを使用するには、指定したオプションに応じて様々な権限が必要です。通常、ユーザーがこのユーティリティを使用するには、インスタンス管理者であるか、またはADMIN権限を持っている必要があります。

-rオプションでは、通常、データベースが作成されるため、このオプションを使用するにはインスタンス管理者の権限が必要です。このオプションを使用する時点ですでにデータベースが作成されている場合は、CREATE ANY TABLE、CREATE ANY SEQUENCE、CREATE ANY VIEW、CREATE ANY MATERIALIZED VIEW、CREATE ANY CACHE GROUP、CREATE ANY INDEXの各権限が必要であり、さらにユーザーの自動作成が必要になる場合にはADMIN権限も必要です。データベースでレプリケーションまたはTimesTen Cacheを使用する場合は、CACHE_MANAGERも必要になります。

-cオプションを使用してデータベース全体を収集するには、ADMIN権限が必要です。データベースでレプリケーションまたはTimesTen Cacheを使用する場合は、CACHE_MANAGERも必要になります。-cオプションを使用して、データベース・オブジェクト(表、ビュー、マテリアライズド・ビュー、キャッシュ・グループ、順序)のサブセットを収集するには、SELECT ANY TABLE権限およびSELECT ANY SEQUENCE権限が必要です。

構文

ttMigrate {-h | -help | -?}

ttMigrate {-V | -version}

バイナリ・データファイルを作成または追加するには、次のように入力します。

ttMigrate {-a | -c} [-v verbosity] [-nf] [-nr] [-fixNaN] [-saveAsCharset charset]
[-relaxedUpgrade | -exactUpgrade]
[-convertTypesToOra | -convertTypestoTT]]
[-activeDML | -noActiveDML]
{-connStr connection_string | DSN} data file [objectOwner.]objectName

このユーティリティで作成されたバイナリ・データファイルからデータベースをリストアするには、次のように入力します。

ttmigrate -r  [-C ckptFreq] [-v level] [-nf] [-nr] [-fixNaN] [-numThreads n]
[-updateStats | -estimateStats percent] [-relaxedUpgrade | -exactUpgrade]
[-inline rule] [-noCharsetConversion] [-cacheUid uid [-cachePwd pwd]]
[-autorefreshPaused] [-convertTypesToOra | -convertTypesToTT]
[-restorePublicPrivs] [-localhost host]
[-delayFkeys | -noDelayFKeys]
{DSN | -connstr connStr} dataFile [objectOwner.objectName...]

このユーティリティで作成されたバイナリ・データファイルの内容をリストまたは表示するには、次のように入力します。

ttMigrate {-l | -L | -d | -D} dataFile [[objectowner.]name ...]

オプション

注意:
追加(-a)または作成(-c)モード、リスト(-l/-L)または説明(-d/-D)モード、およびリストア・モード(-r)は、相互に排他的です。これらのオプションのいずれか2つを同じ行に指定することはできません。

ttMigrateには次のオプションがあります。

オプション

説明

-a

追加モードの選択: ttMigrate -cを使用して作成された、すでに存在しているバイナリ・データファイルにデータを追加します。詳細は、「作成モード(-c)と追加モード(-a)」を参照してください。

-activeDML |-noActiveDML

単一のトランザクションで外部キー階層内のすべての表を保存して、ttMigrate -c操作中にアクティブなDMLがある場合にこれらの表の一貫性を維持します。
-noActiveDMLを指定すると、ttMigrateは、表が外部キーの親であるか子であるかに関係なく、独自のトランザクションで各表を保存します。ttMigrate -c操作中にアクティブなDMLがない場合に、このオプションを使用します。

デフォルトは-noActiveDMLです。

-c

作成モード: 新規にバイナリ・データファイルを作成します。詳細は、「作成モード(-c)と追加モード(-a)」を参照してください。

-cacheUid

非同期ライトスルー・キャッシュ・グループおよびAUTOREFRESH属性が設定されたキャッシュ・グループのリストア時に使用するキャッシュ管理ユーザーID。

-cachePwd

自動リフレッシュ・キャッシュ・グループ、非同期ライトスルー・キャッシュ・グループおよびAUTOREFRESH属性が設定されたキャッシュ・グループのリストア時に使用するキャッシュ管理パスワード。
コマンドラインにキャッシュ管理ユーザーIDを入力したが、キャッシュ管理パスワードを入力しなかった場合は、ttMigrateによってパスワードの入力が要求されます。

-connStr connection_string

データベース名、サーバー名とDSN(必要に応じて)および関連する接続属性を含むODBC接続文字列。

-convertTypesToOra
-convertTypesToTT

TimesTenデータベースのデータ型をOracle Databaseのデータ型に、またはOracle Databaseのデータ型をTimesTenのデータ型に変換します。これらのオプションには、-relaxedUpgradeオプションが必要です。
TimesTen 11.2.2では、デフォルトの型モードはORACLE型モードです。旧リリースのデータベースをTimesTen 11.2.2に移行する場合に-convertTypesToOraが役立ちます。

-convertTypesToTTオプションは、Oracle型がサポートされていない下位リリースへの移行に役立ちます。

これらのオプションはマテリアライズド・ビュー以外のすべての種類の表に適用されます。表の種類には、通常の表、キャッシュされた表、グローバル表および一時表があります。

関連項目: -convertCGTypes、「TimesTenデータ型からOracle Databaseのデータ型への変換」および「Oracle Databaseデータ型からTimesTenデータ型への変換」。

-d

説明モードを選択します。データファイル内のオブジェクトの簡単な説明が表示されます。詳細は、「説明モード(-d)」を参照してください。

-D

詳細説明モードを選択します。データファイル内のオブジェクトの詳細な説明が表示されます。詳細は、「詳細説明モード(-D)」を参照してください。

dataFile

移行オブジェクトの保存先または移行オブジェクトのリストア元のデータファイルのパス名です。

DSN

移行するデータベースのODBCデータソース名を指定します。

-estimateStats percent

ttMigrateで、リストアされた表およびマテリアライズド・ビューの指定された割合の行の統計を見積もることを指定します。percentRowsの適切な値は、0から100です。
-cまたは-aオプションが指定されている場合、ttMigrateはこのオプションを無視します。

-estimateStatsおよび-updateStatsの両方を指定した場合、リストアされた表の統計は更新されますが、見積もられません。

このフラグを使用すると、マテリアライズド・ビューのリストアのパフォーマンスと、リストアされた表およびビューに対する問合せのパフォーマンスが向上する場合があります。

-fixNaN

移行オブジェクト内で検出されたNaN、Inf、-Infの値をすべて0.0に変換します。NaN、Inf、-Infの値がサポートされていないTimesTenのリリースにデータを移行する場合に役立ちます。

-h
-help

-?

使用方法のメッセージを出力して終了します。

-inline rule

リストア・モードで可変長列をINLINEに変換するために使用するruleを指定します。ruleの値は次のいずれかです。
preserve: ttMigrateは各列の元のINLINE属性を保持します。これがデフォルトであり、-exactUpgradeを使用する場合は必須です。

dsDefault: ttMigrateは、リストアされた列のINLINE属性を設定するためにデータベースのデフォルトのルールを使用します。

maxlen: ttMigrateは<maxlen以下の長さのすべての可変長列をINLINEとしてリストアし、maxlenより長いすべての可変長列をNOT INLINEとしてリストアします。

maxlenが0の場合、すべての列はNOT INLINEとしてリストアされます。

INLINE可変長列は、NOT INLINE列には正常にレプリケートできません。

-l

リスト・モードを選択します。指定されたデータファイル内のデータベース・オブジェクトの名前が表示されます。詳細は、「リスト・モード(-l)と詳細リスト・モード(-L)」を参照してください。

-L

詳細リスト・モードを選択します。指定されたデータファイル内のデータベース・オブジェクトの名前と、データベース・オブジェクトに関するその他の詳細が表示されます。詳細は、「リスト・モード(-l)と詳細リスト・モード(-L)」を参照してください。

-r

リストア・モードを選択します。このユーティリティで作成されたバイナリ・データファイルからデータベースをリストアします。詳細は、「リストア・モード(-r)」を参照してください。

name

保存またはリストアするデータベース・オブジェクトの名前。

-nf

通常の(キャッシュされていない)表の保存またはリストア時に、ttMigrateが外部キー情報の保存またはリストアを行わないことを指定します。

-nr

通常の(キャッシュされていない)表の保存またはリストア時に、ttMigrateが表の行の保存またはリストアを行わないことを指定します。

-noAutoCreateUsers

ttMigrateでユーザーが作成されないように指定します。
デフォルトでは、TimesTenでは、11.2.1より前のリリースから表を移行するときに、無効化されたユーザーが作成されます。ユーザーは作成されますが、これらのユーザーには権限が割り当てられません。ユーザーが作成された後、CREATE SESSIONなどの権限をこれらのユーザーに明示的に割り当てる必要があります。

-relaxedUpgrade

TABLE DEFINITION CHECKING RELAXEDを使用するレプリケーション・スキームと互換性のある方法で、表を保存またはリストアします。このオプションを使用すると、使用しない場合に比べてリストアされる表が若干コンパクトになり、アクセスが若干速くなります。
-aオプションが指定されている場合、ttMigrateはこのオプションを無視します。

このオプションは、TABLE DEFINITION CHECKING EXACTを使用するレプリケーション・スキームと組み合せて使用しないでください。使用した場合、レプリケーションが機能しなくなる場合があります。

デフォルトは-exactUpgradeです。

-numThreads n

データベース・ファイルのリストア時に使用するスレッドの数を指定します。指定しない場合、1つのスレッドを使用して、データファイルからオブジェクトがリストアされます。
有効な値は1から32までです。

owner

移行オブジェクトの所有者です。

-exactUpgrade

TABLE DEFINITION CHECKING EXACTを使用するレプリケーション・スキームと互換性のある方法で、表を保存またはリストアします
-cまたは-aオプションが指定されている場合、ttMigrateはこのオプションを無視します。

このオプションは、TABLE DEFINITION CHECKING RELAXEDを使用するレプリケーション・スキームと組み合せて使用しないでください。使用した場合、レプリケーションが機能しなくなる場合があります。INLINE可変長列は、NOT INLINE列には正常にレプリケートできません。

これはデフォルトです。

-saveAsCharset
charset

指定された接続キャラクタ・セットにオブジェクトを保存します。接続キャラクタ・セットがデータベース・キャラクタ・セットと異なる場合、ttMigrateによって情報メッセージが返されます。
このオプションが設定されない場合、ttMigrateはデフォルトで、データベース・キャラクタ・セットに移行オブジェクトを保存します。

-updateStats

ttMigrateで、リストアされた表およびマテリアライズド・ビューの統計を更新することを指定します。
-cまたは-aオプションが指定されている場合、ttMigrateはこのオプションを無視します。

-estimateStatsおよび-updateStatsの両方を指定した場合、リストアされた表の統計は更新されますが、見積もられません。

このフラグを使用すると、マテリアライズド・ビューのリストアのパフォーマンスと、リストアされた表およびビューに対する問合せのパフォーマンスが向上する場合があります。

-v verbosity

ttMigrateがデータベースの保存またはリストアを行うときに出力されるメッセージの冗長レベルを指定します。次のいずれかです。
0: エラーおよび警告のみを表示します。

1: 表の保存またはリストア時に、各表の名前を出力します。

2: 表や索引の保存またはリストア時に、各表または索引の名前を出力します。

3 (デフォルト): 表や索引の保存またはリストア時に、各表または索引の名前を出力し、10,000行が保存またはリストアされるごとにドット(.)を出力します。

ttMigrateは、リスト、詳細リスト、説明および詳細説明の各モードでは、-vオプションを無視します。

-V | -version

ttMigrateのリリース番号を出力し、終了します。

次のttMigrateのオプションは、リストア・モード(-r)でのみ使用できます。

オプション

説明

-autorefreshPaused

自動リフレッシュ状態をPAUSEDにして、AUTOREFRESH属性が設定されているキャッシュ・グループをリストアします。これ以外の場合、この状態はOFFに設定されます。

-C chkPtFreq

chkPtFreqの値(MB)のデータをリストアするたびに、ttMigrateがデータベースのチェック・ポイントを行うことを指定します。0(ゼロ)の値(デフォルト)は、ttMigrateがデータベースのチェック・ポイントを行わないことを指定します。

-convertCGTypes

次の項目を使用して、基礎となるOracle Database表からTimesTenキャッシュ表への最適な型のマッピングを決定します。

- Oracle Database表の列の型。

- 移行ファイルに保存された列の型。

- TimesTen型とOracle型間のマッピング・ルール。

このオプションが-convertTypesToOraまたは-convertTypesToTTオプションのいずれかとともに指定された場合、キャッシュされた表に対しては、このオプションが優先されます。このオプションは、キャッシュされていない表には影響しません。詳細は、『Oracle TimesTen Application-Tier Database Cacheユーザーズ・ガイド』のOracle DatabaseとTimesTenデータ型間のマッピングに関する説明を参照してください。

-delayFkeys | -noDelayFkeys

-delayFkeys - すべての表がリストアされるまで、外部キーの作成を遅らせます。これにより、パラレル移行のパフォーマンスが向上します(ttMigrate -numThreads)。
-noDelayFkeys - CREATE TABLE操作の一部として外部キーを作成します。デフォルトは-noDelayFkeysです。

-localhost hostName

レプリケートされた表をリストアする際に、ローカル・ホストの名前またはIPアドレスを明示的に指定します。

-noCharsetConversion

データファイルに保存された接続キャラクタ・セットを保持したまま、データをリストアします。ttMigrateは、データベース・キャラクタ・セットに合うように接続キャラクタ・セットを変換することはありません。
設定しない場合、ttMigrateはデータをリストアし、接続キャラクタ・セットをデータベース・キャラクタ・セットと同じになるように変換します。

関連項目: -saveAsCharset。

このオプションは、TIMESTEN8またはWE8ISO8895P1などの他のキャラクタ・セットとして、11.2.2より前のデータを11.2.2以上のリリースのTimesTenに移行し、データが実際に別のキャラクタ・セットになっている場合、旧TimesTenのユーザーに役立つ可能性があります。後で、そのデータを実際のキャラクタ・セットに従って解釈することが必要になった場合、このオプションを使用して、データの実際のキャラクタ・セットを使用しているデータベースに、キャラクタ・セットを変換せずにデータを移行します。

-restorePublicPrivs

データベースが作成された後、PUBLICに付与された権限をリストアします。ttMigrateユーティリティでは、デフォルトではPUBLICに付与された権限はリストアされません。PUBLICに対する権限をリストアするには、このオプションを明示的に指定する必要があります。

モード

作成モード(-c)と追加モード(-a)

作成モードでは、ttMigrateが移行オブジェクトをTimesTenデータベースから新規のバイナリ・データファイルに保存します。データファイルがない場合には、ttMigrateが作成します。それ以外の場合は、ttMigrateは既存のファイルを上書きして、その内容を破棄します。

ttMigrateによって使用されるデータファイル形式は、TimesTenのいずれのリリースにも依存していないため、あるTimesTenリリースから別のリリースへデータを移行する場合にttMigrateを使用できます。

追加モードでは、ttMigrateは移行オブジェクトをTimesTenデータベースから既存のデータファイルに追加します。データファイルがない場合には、ttMigrateが作成します。

通常の(キャッシュされていない)各表について、ttMigrateは次のものを保存します。

- 表の説明: 主キーとNULL値可能に関する情報を含む、表の列ごとの名前と型。

- 表の索引定義: 各索引と索引に含まれる列の名前。ttMigrateは、索引の実際の内容は保存せず、表のリストア時に索引を再作成するために必要となる情報のみを保存します。

- 表の外部キー定義。-nfオプションを使用して、外部キー定義の保存を無効にできます。

- 表の行。-nrオプションを使用して行の保存を無効にできます。

各キャッシュ・グループについて、ttMigrateは次のものを保存します。

- キャッシュ・グループの定義: キャッシュ・グループの所有者と名前、キャッシュ・グループ内のすべての表の名前、関連するキャッシュ・グループの設定(キャッシュ・グループの時間など)。

注意:
ttMigrateを使用してデータベースをリストアした後は、ソース・データベースでのAUTOREFRESH STATEの設定方法に関係なく、リストアされたデータベースのすべての自動リフレッシュ・キャッシュ・グループでAUTOREFRESHの状態がOFFに設定されます。ttMigrate -rを使用してキャッシュ・グループをリストアした後は、ALTER CACHE GROUP文を使用して、AUTOREFRESH STATEをONにリセットしてください(この操作はプログラムで実行することも、ttIsqlユーティリティで実行することもできます)。

- キャッシュ・グループ内のすべてのキャッシュされた表: 表名、列情報、表の属性(伝播または読取り専用)、WHERE句(存在する場合)、外部キー定義、索引定義。

各ビューについて、ttMigrateは次のものを保存します。

- 通常の表と同一のすべての情報。

- ビューを定義する問合せ。

各順序について、ttMigrateは次のものを保存します。

- 順序の完全な定義。

- 順序の現在の値。

(インスタンス管理者を除く)ユーザーごとに、ttMigrateは次のものを保存します。

- ユーザーの名前。

- ユーザーの暗号化されたパスワード。

- ユーザーに付与されている権限。

PUBLICの場合、ttMigrateはデータベース作成後にPUBLICに付与されたすべての権限を保存します。

レプリケーション・スキームが定義されている場合、ttMigrateはレプリケーション・スキームを含むすべてのTTREP表を保存します。レプリケーション・スキームは、他のすべてのデータストア・オブジェクトとは別の一意の名前である必要があります。他のデータベース・オブジェクトと同じ名前のレプリケーション・スキームは移行できません。

注意:
ttMigrateユーティリティは、-nrオプションを指定しなかった場合でも、キャッシュされた表の行をデータファイルに保存しません。キャッシュされた表の外部キー定義は、キャッシュ・グループの整合性を保つために必要となるため、-nfオプションの使用にかかわらず、常に保存されます。

デフォルトでは、ttMigrateは、表、ビュー、キャッシュ・グループ、順序、ユーザー、レプリケーション・スキームなど、データベース内のすべてのデータベース・オブジェクトおよびユーザーをデータファイルに保存します。また、レプリケーション・スキームを除き、保存するデータベース・オブジェクトのリストをコマンドラインに指定することもできます。このリスト内の名前には、ワイルド・カード文字の%(1文字以上に一致)と_(単一の文字に一致)を含めることができます。ttMigrateは、指定されたパターンのいずれかに一致する、すべてのデータベース・オブジェクトを保存します。名前を完全修飾する必要はなく、所有者なしで名前を指定すると、ttMigrateは、その名前またはパターンに一致するすべてのデータベース・オブジェクトについて、所有者を考慮せずに保存します。

キャッシュされた表は、キャッシュ・グループから独立させて保存することはできません。キャッシュされた表をコマンドラインでリストしても、対応するキャッシュ・グループもリストしなければ、ttMigrateはエラーを発行します。

-vオプションを使用して、保存の処理中にttMigrateによって出力される情報を制御します。

リストア・モード(-r)

リストア・モードでは、ttMigrateはすべてのデータベース・オブジェクトをデータファイルからTimesTenデータベースにリストアします。

通常の(キャッシュされていない)各表について、ttMigrateは次のものをリストアします。

- 表(元の所有者、表名、列名、型、NULL値可能に関する設定、オリジナルの主キーを使用)。

- 表の外部キー。-nfフラグを使用して、外部キーのリストアを無効にできます。

- 表のすべての索引。

- 表のすべての行。-nrフラグを使用して、行のリストアを無効にできます。

各キャッシュ・グループについて、ttMigrateは次のものをリストアします。

- キャッシュ・グループ定義(元のキャッシュ・グループ所有者と名前を使用)。

- キャッシュ・グループ内のすべてのキャッシュされた表(元の表名、列名、型、NULL値可能、元の主キー、表属性(PROPAGATEまたはREADONLY)、およびWHERE句(存在する場合)を使用)。

- キャッシュされた表の外部キー定義。

- キャッシュされた表のすべての索引。

注意:
ttMigrateユーティリティは、-nrオプションを指定しなかった場合でも、キャッシュされた表の行をリストアしません。キャッシュされた表の外部キー定義は、キャッシュ・グループの整合性を保つために必要となるため、-nfオプションの使用にかかわらず、常にリストアされます。

デフォルトでは、リストア中に-exactUpgradeオプションが設定されます。

デフォルトでは、ttMigrateはデータファイル内のすべての表とキャッシュ・グループをリストアします。また、リストアする特定の表とキャッシュ・グループをコマンドラインにリストすることもできます。このリスト内の名前は完全修飾する必要があり、ワイルド・カード文字は使用できません。

キャッシュされた表は、キャッシュ・グループから独立させてリストアすることができません。キャッシュされた表をコマンドラインでリストしても、対応するキャッシュ・グループもリストしなければ、ttMigrateはエラーを発行します。

-vオプションを使用して、リストアの処理中にttMigrateによって出力される情報を制御します。

-inlineオプションを使用すると、可変長列をINLINEとしてリストアするか、NOT INLINEとしてリストアするかを制御できます。詳細は、『Oracle TimesTen In-Memory Database SQLリファレンス・ガイド』のデータ型の仕様に関する説明を参照してください。デフォルト・モード(-inlinepreserve)では、ttMigrateはすべての可変長列を、それらが保存されたときと同じINLINEまたはNOT INLINE設定でリストアします。その他の2つのモード(-inlinedsDefaultおよび-inlinemaxlen)では、ttMigrateはしきい値長以下の可変長列をINLINEとしてリストアし、他の可変長列をすべてNOT INLINEとしてリストアします。-inlinedsDefaultでは、このしきい値はTimesTenデータベースのデフォルトの自動INLINE長です。-inlinemaxlenモードでは、ユーザー定義のしきい値長(maxlen)を持つ可変長列は、INLINEとしてリストアされ、その他のすべての可変長列は、INLINEとして保存されている場合でも、NOT INLINEとしてリストアされます。maxlenが0の場合、すべての可変長列はNOT INLINEとしてリストアされます。

リスト・モード(-l)と詳細リスト・モード(-L)

リスト・モードでは、ttMigrateは、キャッシュされた表およびレプリケーション・スキームTTREP表などの、指定したデータファイル内のデータベース・オブジェクトの名前を表示します。

詳細リスト・モードでは、ttMigrateは、キャッシュされた表およびレプリケーション・スキームTTREP表などのデータファイル内の、データベース・オブジェクトの名前の他に、各表の行数と各表の索引定義、各ビューを定義する問合せ、および各順序の仕様を表示します。

デフォルトでは、ttMigrateは、レプリケーション・スキーム名およびファイル内のすべてのデータベース・オブジェクトを表示します。また、コマンドラインにデータベース・オブジェクト名のリストを指定することもできます。このリスト内の名前は完全修飾する必要があり、ワイルド・カード文字は使用できません。

説明モード(-d)

説明モードでは、ttMigrateは、指定したファイル内のデータベース・オブジェクトに関する簡単な説明を提供します。

各表について、ttMigrateは表名、表の行数、表の列定義、主キーおよび外部キーを表示します。キャッシュされた表については、ttMigrateは、表の属性(PROPAGATEまたはREADONLY)および表のWHERE句(存在する場合)も表示します。

ビューについて、ttMigrateはビューを定義する問合せも表示します。

キャッシュ・グループについて、ttMigrateはキャッシュ・グループ名、キャッシュ・グループ内の表の数、キャッシュ・グループの持続時間を表示し、キャッシュ・グループ内のキャッシュされた各表について説明します。

レプリケーション・スキームについて、ttMigrateは、レプリケーション・スキーム名およびすべてのTTREPレプリケーション・スキーム表をユーザー表と同様の方法で表示します。

デフォルトでは、ttMigrateは、ファイル内のデータベース・オブジェクトをすべて示します。また、コマンドラインにデータベース・オブジェクト名のリストを指定することもできます。このリスト内の名前は完全修飾する必要があり、ワイルド・カード文字は使用できません。

詳細説明モード(-D)

詳細説明モードでは、ttMigrateは指定したファイル内のデータベース・オブジェクトに関する詳細な説明を提供します。

各表について、ttMigrateは表名、表の行数、表の列定義、主キー、外部キーおよび索引定義を表示します。キャッシュされた表については、ttMigrateは、表の属性(PROPAGATEまたはREADONLY)および表のWHERE句(存在する場合)も表示します。

キャッシュ・グループについて、ttMigrateはキャッシュ・グループ名、キャッシュ・グループ内の表の数、キャッシュ・グループの持続時間を表示し、キャッシュ・グループ内のキャッシュされた各表について説明します。

順序について、ttMigrateは順序の現在の値に加えて、その順序の定義に使用されたすべての値を表示します。

レプリケーション・スキームについて、ttMigrateは、すべてのTTREPレプリケーション・スキーム表をユーザー表と同様の方法で表示します。

デフォルトでは、ttMigrateは、ファイル内のデータベース・オブジェクトをすべて示します。また、コマンドラインにデータベース・オブジェクト名のリストを指定することもできます。このリスト内の名前は完全修飾する必要があり、ワイルド・カード文字は使用できません。

TimesTenデータ型からOracle Databaseのデータ型への変換

TimesTen 11.2.2では、TimesTenとOracle Databaseの両方のデータ型がサポートされており、以前のバージョンのTimesTenからTimesTen 11.2.2にデータベースを移行する場合は、データベースのデータ型をデフォルトのOracle型モードに変換できます。ただし、これは必須ではありません。

レプリケーションの場合は、レプリケーション・スキーム内のレプリケーションする側とされる側のデータ型モードが同じであることが必要です。したがって、11.2.2より前のTimesTenリリースではOracle Databaseデータ型がサポートされていないため、オンライン・アップグレードの一部としてデータ型を変換することはできません。

注意:
-convertTypesToOraが指定されていて、データベースに精度が38を超えるDECIMAL(またはNUMERIC)列が存在する場合、その列は精度が38のNUMBER列に変換され、警告が返されます。列に値が存在する場合にこの変換が行われると、精度38でオーバーフローまたはアンダーフローし、値は精度38のNUMBER型が取り得る最大値に減らされるか、または最小値に増やされます。このような事例が考えられるため、データ型の変換処理(-convertTypesToOraおよび-convertTypesToTTを使用)では、元のデータ型に戻せる状態になることは保証されていません。TT型からORA型に変換し、再度TT型に変換すると、場合によっては最初と異なる列およびデータになる可能性があります。

TimesTenデータ型からOracle Databaseのデータ型に変換するには、-convertTypesToOraオプションを使用します。

-convertTypesToOraオプションは、ttMigrateで表の保存またはリストアを行う際に、次の型変換を実行するようにttMigrateに指示します。

変換前のTimesTen型

変換後のOracle型

TT_CHAR

ORA_CHAR

TT_VARCHAR

ORA_VARCHAR2

TT_NCHAR

ORA_NCHAR

TT_NVARCHAR

ORA_NVARCHAR2

TT_DECIMAL

ORA_NUMBER

TT_DATE

ORA_DATE(12:00:00 amが追加されます)

TT_TIMESTAMP

ORA_TIMESTAMP(6)

注意:
データ型がTT_TINYINT、TT_SMALLINT、TT_INTEGER、TT_BIGINT、BINARY_FLOAT、BINARY_DECIMAL、TT_BINARY、TT_VARBINARYおよびTT_TIMEの列は変換されません。

データ型の詳細は、『Oracle TimesTen In-Memory Database SQLリファレンス・ガイド』のデータ型に関する説明を参照してください。

Oracle Databaseデータ型からTimesTenデータ型への変換

11.2.2より前のリリースではOracle Databaseデータ型がサポートされていないため、TimesTenリリース11.2.2から下位バージョンのTimesTenに表を移行する際に、Oracle Databaseデータ型をTimesTenデータ型に変換する必要があります。

Oracle Databaseデータ型からTimesTenデータ型に変換するには、-convertTypesToTTオプションを使用します。

-convertTypesToTTオプションは、ttMigrateユーティリティで表の保存またはリストアを行う際に、次の型変換を実行するようにttMigrateに指示します。

変換前のOracle型

変換後のTimesTen型

ORA_CHAR

TT_CHAR

ORA_VARCHAR2

TT_VARCHAR

ORA_NCHAR

TT_NCHAR

ORA_NVARCHAR2

TT_NVARCHAR

ORA_NUMBER

TT_DECIMAL

ORA_DATE

TT_DATE(日付の時間部分が暗黙で切り捨てられます)

ORA_TIMESTAMP

TT_TIMESTAMP

データ型の詳細は、『Oracle TimesTen In-Memory Database SQLリファレンス・ガイド』のデータ型に関する説明を参照してください。

キャッシュ・グループのデータ型の変換

リリース7.0より前のTimesTenからキャッシュ・グループを含むデータベースをリストアする場合は、-convertCGTypesオプションを使用して、7.0より前の型と、キャッシュ・グループに関連付けられているOracle Databaseの列のデータ型を正確にマッピングして、列のデータ型を変換します。

次の表に、型のマッピングを示します。

7.0より前のTimesTen型

Oracle型

変換後の型

TINYINT

NUMBER(p,s) when s > 0

NUMBER(p,s)

TINYINT

NUMBER(p,s) when s <= 0

TT_TINYINT

SMALLINT

NUMBER(p,s) when s > 0

NUMBER(p,s)
TT_SMALLINT

SMALLINT

NUMBER(p,s) when s <= 0

TT_SMALLINT

INTEGER

NUMBER(p,s) when s > 0

NUMBER(p,s)

INTEGER

NUMBER(p,s) when s <= 0

TT_INTEGER

BIGINT

NUMBER(p,s) when s > 0

NUMBER(p,s)

BIGINT

NUMBER(p,s) when s <= 0

TT_BIGINT

NUMERIC(p,s)DECIMAL(p,s)

NUMBER

NUMBER

NUMERIC(p,s)DECIMAL(p,s)

NUMBER(x,y)

NUMBER(x,y)

NUMERIC(p,s)DECIMAL(p,s)

FLOAT(x)

NUMBER(p,s)

REAL

任意

BINARY_FLOAT

DOUBLE

任意

BINARY_DOUBLE

FLOAT(x) x <=24

任意

BINARY_FLOAT

FLOAT(x) x >= 24

任意

BINARY_DOUBLE

CHAR(x)

任意

ORA_CHAR(x)

VARCHAR(x)

任意

ORAVARCHAR2(x)

BINARY(x)

任意

TT_BINARY(x)

VARBINARY(x)

任意

TT_VARBINARY(x)

DATE

DATE

ORA_DATE

TIMESTAMP

DATE

ORA_DATE

TIME

DATE

ORA_DATE

Any1

TIMESTAMP(m)

ORA_TIMESTAMP(m)

注意:
anyは、型の値が変換後の型に影響しないことを示します。

データ型の詳細は、『Oracle TimesTen In-Memory Database SQLリファレンス』のデータ型に関する説明および『Oracle TimesTen Application-Tier Database Cacheユーザーズ・ガイド』のOracle DatabaseとTimesTenデータ型間のマッピングに関する説明を参照してください。

戻りコード

ttMigrateユーティリティのリストア(-r)および作成(-c)コマンドは次の終了コードを返します。

0: すべてのオブジェクトは正常に作成またはリストアされました。

1: 一部のオブジェクトは正常に作成またはリストアされました。エラーのため、一部のオブジェクトは作成またはリストアできませんでした。

2: 致命的エラー。たとえば、データファイルに接続できなかったか、データファイルを開けませんでした。

3: 作成またはリストア処理中に[Ctrl]キーを押しながら[C]キーが押されたか、別のシグナルを受信しました。

例

次のコマンドでは、すべてのデータベース・オブジェクトが、データベースSalesDSからファイルsales.ttmにダンプされます。sales.ttmが存在している場合は、ttMigrateによって上書きされます。

ttMigrate -c SalesDS sales.ttm

次のコマンドでは、ユーザーMARYが所有するSalesDSデータベース内のすべてのデータベース・オブジェクトをsales.ttmに追加します。

ttMigrate -a SalesDS sales.ttm MARY.%

次のコマンドでは、sales.ttmのすべてのデータベース・オブジェクトをSalesDSデータベースにリストアします。

ttMigrate -r SalesDS sales.ttm

次のコマンドでは、sales.ttmのMARY.PENDINGおよびMARY.COMPLETEDをSalesDSデータ・ストアにリストアします(移行オブジェクトでは大/小文字は区別されません)。

ttMigrate -r SalesDS sales.ttm MARY.PENDINGMARY.COMPLETED

このコマンドでは、sales.ttmに保存されたすべての移行オブジェクトを表示します。

ttMigrate -l sales.ttm

注意

現行リリースの機能をサポートしていないOracle TimesTen In-Memory Databaseのリリースに対して下位方向の移行を行う場合、通常、TimesTenは警告を発行し、サポートされていない機能を移行せずに処理を続行します。オブジェクトの変換を実行済の場合、まれに、ttMigrateが失敗し、エラー・メッセージが返されることがあります。データ型、キャラクタ・セットおよび主キー表現の変換が行われた場合に失敗することがあります。

次の制約、制限およびアドバイスを検討してから、ttMigrateを使用する準備をしてください。

非同期マテリアライズド・ビュー: 以前のリリースに移行する場合、非同期マテリアライズド・ビューは無視され、TimesTenから警告が返されます。

キャッシュ・グループ: リストア・モードでは、表間に外部キーの依存性がある場合は、ttMigrateで表の順番を整理しなおして、子表が親表より先にリストアされないようにすることが必要になる場合があります。

キャッシュ・グループを含むデータベースを以前のリリースのTimesTenからTimesTen 7.0以降のリリースに移行する場合、オプション-convertTypesToOraを使用する必要があります。データ型のマッピングに関する説明は、「キャッシュ・グループのデータ型の変換」を参照してください。

キャッシュされた表内の文字型の列は、長さのみでなくバイト・セマンティクスも、基礎となるOracle Database表と同じであることが必要です。キャッシュされた表に、長さまたは長さセマンティクスの不一致がある場合、キャッシュ・グループの移行は失敗します。

このユーティリティでは、0以外の値を指定したPassThrough接続属性はサポートされていないため、0以外の値を指定するとエラーが返されます。

キャラクタ・セット: デフォルトでは、-saveAsCharsetオプションを指定しないかぎり、ttMigrateは表データをデータベース・キャラクタ・セットで保存します。異なるデータベース・キャラクタ・セットのデータベースに表を移行することにより、他のキャラクタ・セットへの変換がリストア時に実行されます。7.0より前のリリースのTimesTenからデータを移行する場合、TimesTenは、データがすでに移行先のデータベース・キャラクタ・セットになっていると想定します。データのデータベース・キャラクタ・セットが移行先のデータベースと同じでない場合、データが正しくリストアされない可能性があります。

NLSがサポートされているがデータベース・キャラクタ・セットが異なる2つのデータベースの間で、BYTE長セマンティクスが指定された列を移行する場合、新しいデータベース内の列の長さが、移行ファイルに含まれる値を保持するのに十分でない場合、移行が失敗する可能性があります。たとえば、移行元データベースでは最大バイト長が4のキャラクタ・セットを使用していて、移行先データベースでは最大バイト長が2のキャラクタ・セットを使用している場合に移行が失敗する可能性があります。

TimesTenでは、キャラクタ・セットの変換が行われる場合に常に警告を発行し、変換によるデータの損失の可能性を知らせます。

データ型の変換: 7.0より前のリリースのTimesTenからデータを移行する場合、-convertTypesToOraオプションまたは-convertTypesToTTオプションのいずれかを使用して、データ型の変換を明示的にリクエストする必要があります。

ttMigrateでは、CHARまたはVARCHAR列の長さセマンティクスの注釈(BYTEまたはCHAR)が保存され、これらがサポートされているTimesTenのリリースにリストアする際に、これらの注釈がリストアされます。これらの注釈がサポートされていないTimesTenリリースに下位方向の移行を行う場合、CHAR長セマンティクスが指定された列はBYTE長による指定に変換されますが、元の列のバイト長と一致するように長さが調整されます。これらの注釈がサポートされていないリリースから上位方向に移行する場合、BYTE長セマンティクスが使用されます。

外部キーの依存性: リストア・モードでは、表間に外部キーの依存性がある場合は、ttMigrateで表の順番を整理しなおして、子表が親表より先にリストアされないようにすることが必要になる場合があります。このような依存性により、親表が1つでもリストアされなかった場合に子表がリストアされるのを回避することもできます。たとえば、表Bに対して外部キーの依存性を持つ表Aをリストアする場合、ttMigrateは最初に表Bがデータベースに存在することを確認します。表Bが検出されない場合、ttMigrateは表Bがリストアされるまで表Aのリストアを遅らせます。表BがttMigrateセッションの一部としてリストアされない場合、依存性を解決できなかったため表Aがリストアされなかったことを示すエラー・メッセージがTimesTenによって出力されます。

索引: TimesTenでは、この機能をサポートしているTimesTenの各リリースの主キー索引として範囲索引をサポートします。主キー索引としての範囲索引がサポートされていないリリースに下位方向の移行を行う場合、主キーはデフォルト・サイズのハッシュ索引としてリストアされます。主キー索引としての範囲索引がサポートされていないリリースから上位方向の移行を行う場合、主キーは元の索引と同じサイズのハッシュ索引としてリストアされます。

TimesTenはビットマップ索引もサポートしています。ビットマップ索引をサポートしていないリリースに下位方向の移行を行う場合、ttMigrateはビットマップ索引を範囲索引に変換します。

INLINE列: INLINE可変長列を含むTimesTen表を、5.1より前のリリースのTimesTenに移行する場合は、明示的に-relaxedUpgradeオプションを使用する必要があります。デフォルトの-exactUpgradeオプションを使用すると、エラーが発生します。-inlineオプションを使用して他の指定をしないかぎり、列のINLINE属性は保持されます。

マテリアライズド・ビュー・ログ: TimesTenはマテリアライズド・ビュー・ログの内容を保存せず、定義のみを保存します。

レプリケーション: レプリケートされたデータベース全体の移行を実行する前に、移行元データベースと移行先データベースのホスト名とデータベース名が同じであることを確認する必要があります。

システム・ビュー: TimesTenは移行中にシステム・ビューの定義または内容を保存しません。

その他の注意事項: ttMigrateではバイナリ形式が使用されるため、次の処理には使用できません。

- ハードウェア・プラットフォーム間でのデータベースの移行。

- ttBackupで保存されたデータのリストア、またはttMigrateで保存されたデータをリストアするためのttBackupの使用。

プラットフォーム: ttMigrateをttMigrateCS (ttMigrateのクライアント・サーバー・バージョン)とともに使用して、32ビットと64ビットのプラットフォームまたはビット・レベル間でデータベースを移行できます。新しいビット・レベルでデータをリストアする場合、-relaxedUpgradeオプションを使用する必要があります。ビット・レベルを変更する場合、レプリケーション・スキームにデータベースを含めることはできません。『Oracle TimesTen In-Memory Databaseインストレーション・ガイド』の32ビット・プラットフォームと64ビット・プラットフォーム間のデータベースの移動に関する項の例に従います。

- Windowsでは、どのリリースのTimesTenからでもttMigrateを使用してデータベースにアクセスできます。Windowsでは、すべてのTimesTen Data ManagerおよびクライアントDSNで、このユーティリティがサポートされています。

- UNIXでは、ttMigrateのリリースは接続中のデータベースのリリースと一致する必要があります。

アプリケーションのロックの競合問題を回避するために、ttMigrate実行中はDDL SQLを実行しないことをお薦めします。

関連項目

ttBackup
ttBulkCp
ttRestore

ttmodinstall

説明

特定のインストール用に指定した設定を変更します。

必要な権限

このユーティリティには、インスタンス管理者の権限が必要です。

構文

ttmodinstall {-h | -help | -?}
ttmodinstall {-V | -version}
ttmodinstall -port portNumber
ttmodinstall -tns_admin path
ttmodinstall -enablePLSQL
ttmodinstall -crs

オプション

ttmodinstallには、次のオプションがあります。

オプション

説明

-h
-help

-?

ヘルプ情報を表示します。

-crs

Oracle Clusterware構成を作成または変更します。
詳細は、『Oracle TimesTen In-Memory Database開発者および管理者ガイド』のOracle Clusterwareを使用したアクティブ・スタンバイ・ペアの管理に関する説明を参照してください。

-enablePLSQL

データベースでPL/SQLを有効にします。

-port portNumber

TimesTenの現在のインスタンスで使用しているデーモン・ポートをportNumberに変更します。これは、インストール時にTimesTenに割り当てたポートが、他のプロセスによってリスニングされていることを検出した場合に役立ちます。
また、TimesTenクラスタ・エージェントのポートを割り当てるためにこのオプションを使用することもできます。詳細は、『Oracle TimesTen In-Memory Database開発者および管理者ガイド』のOracle Clusterwareを使用したアクティブ・スタンバイ・ペアの管理に関する説明を参照してください。

-tns_admin path

TNS_ADMIN環境変数の値を設定します。tnsnames.oraファイルが存在するディレクトリを指定します。

-V | -version

TimesTenのバージョン情報を表示します。

例

TimesTenインスタンスのポート番号を12345に変更するには、次のように実行します。

ttmodinstall -port 12345

注意

このユーティリティを使用するには、TimesTenのすべての処理を停止する必要があります。このユーティリティでは、TimesTenデーモンを停止した後再起動してから、インスタンスに対する変更が行われます。

ttRepAdmin

説明

既存のレプリケーション定義を表示し、レプリケーション・ステータスを監視します。『Oracle TimesTen In-Memory Databaseインストレーション・ガイド』で説明しているように、新しいリリースのTimesTenへのアップグレードにも、ttRepAdminユーティリティを使用できます。

必要な権限

このユーティリティには、ADMIN権限が必要です。

構文

ttRepAdmin {-h | -help | -?}
ttRepadmin {-V | -version}
ttRepAdmin -self -list [-scheme [owner.]schemeName]
{DSN | -connStr connectionString}

ttRepAdmin -receiver [-name receiverName]
[-host receiverHostName] [-state receiverState] [-reset]
[-list] [-scheme [owner.]schemeName]
{DSN | -connStr connectionString}

ttRepAdmin -log {DSN | -connStr connectionString}

ttRepAdmin -showstatus {-awtmoninfo} {DSN | -connStr connectionString}

ttRepAdmin -showconfig {DSN | -connStr connectionString}

ttRepAdmin -bookmark {DSN | -connStr connectionString}

ttRepAdmin -wait [-name receiverName] [-host receiverHostName]
[-timeout seconds] {DSN | -connStr connectionString}

ttRepAdmin -duplicate -from srcDataStoreName
-host srcDataStoreHost
[-localIP localIPAddress] [-remoteIP remoteIPAddress]
[-setMasterRepStart] [-ramLoad] [-delXla]
[-UID userId] [-PWD pwd | -PWDCrypt encryptedPwd]
[-drop { [owner.]table ... | [owner.]sequence |ALL }]
[-truncate { [owner.]table ... | ALL }]
[-compression 0 | 1] [-bandwidthmax maxKbytesPerSec]
[-initCacheDr [-noDRTruncate][-nThreads]]
[-keepCG [-cacheUid cacheUid [-cachePwd cachePwd]]
[-recoveringNode | -deferCacheUpdate]
| -nokeepCG]
[-remoteDaemonPort portNo] [-verbosity {0|1|2}]
[-localhost localHostName]
{destDSN | -connStr connectionString}

ttRepAdminの処理

ttRepAdminユーティリティは、数多くのレプリケーション処理に使用されます。これらの処理は、次のカテゴリに分類されます。

- ヘルプおよびバージョン情報

- データベース情報

- サブスクライバ・データベース処理

- データベースの複製

- 更新完了の待機

- レプリケーション・ステータス

ヘルプおよびバージョン情報

次の形式でttRepAdminを使用すると、ヘルプおよびTimesTenの現在のバージョンを取得できます。

ttRepAdmin {-h | -help | -?}
ttRepadmin {-V | -version}

オプション

説明

-h
-help

-?

ヘルプ情報を表示します。

-V | -version

TimesTenのバージョン情報を表示します。

データベース情報

次の形式でttRepAdminを使用すると、データベースに関するサマリー情報を取得できます。

ttRepAdmin -self -list [-scheme [owner.]schemeName]
{DSN | -connStr connectionString}

オプション

ttRepAdmin -self -listには、次のオプションがあります。

オプション

説明

DSN

マスター・データベースまたはサブスクライバ・データベースのデータソース名。

-connStr connection_string

マスター・データベースまたはサブスクライバ・データベースの接続文字列。

-self

指定されたデータベース。

-list

データベース名、ホスト、ポート番号およびブックマークの位置を表示します。

-scheme [owner.]schemeName]

(2つ以上のスキームがある場合)レプリケーション・スキーム名。

例

ttRepAdmin -self -list my_dsn

前述の構文によって、データベースmy_dsnのレプリケーション定義に関する情報が表示されます。

サブスクライバ・データベース処理

次の形式のttRepAdminを使用すると、ステータスのチェックまたはサブスクライバ(レシーバ)・データベースの状態の再設定を実行できます。

ttRepAdmin -receiver [-name receiverName]
[-host receiverHostName]
[-state receiverState] [-reset]
[-list] [-scheme [owner.]schemeName]
{DSN | -connStr connectionString}

オプション

ttRepAdmin -receiverには、次のオプションがあります。

オプション

説明

DSN

マスター・データベースのデータソース名。

-connStr connection_string

マスター・データベースの接続文字列。

-receiver

マスター・データベースから更新を受信するサブスクライバ・データベース。-nameおよび-hostを使用すると、特定のサブスクライバ・データベースを指定できます。

-name receiverName

特定のサブスクライバ(受信側)・データベース。receiverNameは、データベース・パス名の最後の部分です。

-host receiverHostName

サブスクライバ・ホストのホスト名またはTCP/IPアドレス。

-state start
-state stop

-state pause

サブスクライバのレプリケーションの状態を設定します。
start(デフォルト): サブスクライバへのレプリケーションを開始します。

stop: サブスクライバへのレプリケーションを停止し、更新を破棄します。

pause:更新を保持したまま、レプリケーション・エージェントを一時停止します。

詳細は、『Oracle TimesTen In-Memory Database開発者および管理者ガイド』のサブスクライバのレプリケーション状態の設定に関する説明を参照してください。

-reset

特定のサブスクライバに送信される最新のトランザクションに関する、マスター・データベースのログのブックマークを消去します。このオプションは、たとえば、データベースがttMigrateまたはttBackupを使用して再作成される場合のように、マスター・データベースのトランザクションの番号が変更される場合にのみ、使用してください。マスター・データベースがttBackupおよびttRestoreを使用して、保存およびリストアされる場合は、トランザクションの番号が保持されるため、このオプションは使用しないでください。

-list

レプリケーション定義に関する情報を表示します。

-scheme [owner.]schemeName]

2つ以上のスキームがある場合に、レプリケーション・スキーム名を指定します。

例

ttRepAdmin -receiver -list my_dsn

前述の構文によって、マスター・データベースmy_dsnのすべてのサブスクライバのレプリケーション情報が表示されます。

ttRepAdmin -receiver -name rep_dsn -list my_dsn

前述の構文によって、マスター・データベースmy_dsnのrep_dsnサブスクライバのレプリケーション情報が表示されます。

ttRepAdmin -receiver -name rep_dsn -reset my_dsn

前述の構文によって、マスター・データベースのrep_dsnサブスクライバに対するレプリケーションのブックマークが再設定されます。レプリケートされたデータベースをttMigrateまたはttBulkCpで移行する場合にのみ使用してください。

ttRepAdmin -receiver -name rep_dsn -state Start my_dsn

前述の構文によって、マスター・データベースmy_dsnに対してrep_dsnサブスクライバ・データベースのレプリケーション状態が Start 状態に再設定されます。

データベースの複製

次の形式のttRepAdminを使用すると、マスター・データベースと同じコンテンツを持つ新しいデータベースを作成できます。

ttRepAdmin -duplicateを実行するには、次の条件を満たす必要があります。

- インスタンス管理者のみがttRepAdmin -duplicateを実行できます。

- ttRepAdmin -duplicateを実行するには、インスタンス管理者のオペレーティング・システム・ユーザー名がソース・コンピュータとターゲット・コンピュータで同じである必要があります。

- -UIDオプションおよび-PWDオプションを使用して、ソース・データベースに対してADMIN権限を持つ内部ユーザーのユーザー名およびパスワードを指定する必要があります。

- ターゲット・ホストに対してttRepAdminを実行する必要があります。

- DSNの指定は、サーバーDSNではなく、ダイレクトモードDSNである必要があります。

ttRepAdmin -duplicateコマンドを実行する前に、ttStatusを使用して、ソース・データベースに対してレプリケーション・エージェントが起動していることを確認します。

ttRepAdmin -duplicate -from srcDataStoreName
-host srcDataStoreHost
[-localIP localIPAddress] [-remoteIP remoteIPAddress]
[-setMasterRepStart] [-ramLoad] [-delXla]
-UID userId (-PWD pwd | -PWDCrypt encryptedPwd)
[-drop { [owner.]table ... | [owner.]sequence |ALL }]
[-truncate { [owner.]table ... | ALL }]
[-compression 0 | 1] [-bandwidthmax maxKbytesPerSec]
[-initCacheDr [-noDRTruncate] [-nThreads]]
[-keepCG [-cacheUid cacheUid [-cachePwd cachePwd]]
[-recoveringNode | -deferCacheUpdate]
|-nokeepCG]
[-remoteDaemonPort portNo] [-verbosity {0|1|2}]
[-localhost localHostName]
{destDSN | -connStr connectionString}

オプション

ttRepAdmin -duplicateには、次のオプションがあります。

オプション

説明

-bandwidthmax maxKbytesPerSec

複製処理によってmaxKbytesPerSec KB/sを超えるデータがネットワークに送信されないように指定します。値0は、帯域幅に制限がないことを示します。デフォルトは0です。最大値は9999999です。

-compression 0 | 1

複製処理中の圧縮を有効または無効にします。デフォルトは0(無効)です。

-connStr connection_string

新しいデータベースの接続文字列を指定します。

-delXla

複製処理の一部として、すべてのXLAブックマークを削除します。このオプションは、複製データベースにブックマークをコピーしない場合に使用します。

destDSN

新しいデータベースのデータソース名を示します。

-drop {[owner.]table ... |[owner.]sequence |ALL

-duplicate処理中にコピーされたものの、レプリケーション・スキームには含まれていない表または順序を破棄します。表がキャッシュ・グループ表の場合には、ttRepAdminはオプションを無視します。

-duplicate

ネットワーク間でデータベースの内容を転送するために、指定したデータベースの複製をレプリケーションを使用して作成します。『Oracle TimesTen In-Memory Database開発者および管理者ガイド』のデータベースの複製に関する説明を参照してください。

-from srcDataStoreName

-duplicateとともに使用して、送信側データベース(またはマスター・データベース)の名前を指定します。srcDataStoreNameは、データベース・パス名の最後の部分です。

-host srcDataStoreHost

送信側データベース(またはマスター・データベース)のホスト名またはTCP/IPアドレスを定義します。

-initCacheDr

障害時リカバリを初期化します。-cacheUidオプションおよび-cachePwdオプションとともに使用する必要があります。

-keepCG [-cacheUid cacheUid -cachePwd cachePwd] [-recoveringNode | -deferCacheUpdate] | -noKeepCG

-keepCGおよび-noKeepCGでは、キャッシュ・グループの表をキャッシュ・グループ表として維持するか、またはターゲット・データベースの通常の表に変換するかを指定します。デフォルトは-noKeepCGです。
cacheUidは、キャッシュ管理ユーザーIDです。

cachePwdは、キャッシュ管理者ユーザーのパスワードです。

パスワードを指定しなかった場合、ttRepAdminからパスワードの入力を求められます。

Oracle Databaseに接続できない場合またはOracle Databaseが停止している場合は、-duplicateを使用しているときに-recoveringNodeオプションを指定して、すべてのAWTまたは増分自動リフレッシュ・キャッシュ・グループを含むレプリケーション・スキームの失敗したノードをリカバリします。あるいは、-deferCacheUpdateオプションを指定します。これらのオプションにより、(AWTまたは増分自動リフレッシュ・キャッシュ・グループの管理に使用される)Oracle Databaseにあるメタデータに対する変更は、複製操作が完了し、キャッシュ・エージェントおよびレプリケーション・エージェントが起動し、これらのエージェントがOracle Databaseに接続できるようになるまで遅延します。詳細は、『Oracle TimesTen In-Memory Database開発者および管理者ガイド』のデータベースの複製に関する説明を参照してください。

-localhost hostName

-duplicateおよび-setMasterRepStartとともに使用して、ローカル・ホストの名前またはIPアドレスを明示的に指定します。

-localIP localIPAddress

使用するローカル・ネットワーク・インタフェースの別名またはIP(IPv4またはIPv6)アドレスを指定します。指定しない場合は、ttRepAdminによって互換性のあるインタフェースが選択されます。

-noDRTruncate

-initCacheDrオプションとともに使用した場合、-noDRTruncateは障害時リカバリ・サイトでのリモート・サブスクライバの初期導入プロセスにおけるOracle表の切捨てを無効にします。–noDRTruncateを指定した場合、TimesTenはアクティブ・スタンバイ・ペアのレプリケーション・スキームの非同期のWRITETHROUGHキャッシュ・グループ表に対応するOracle Database表を切り捨てません。

-nThreads n

-initCacheDrオプションとともに使用した場合、-nThreadsは、初期化プロセスにおけるOracle Database表の切捨ておよびOracleへのキャッシュ・データのプッシュに使用するスレッドの数を示します。

-PWD pwd

-UIDオプションに指定した内部ユーザーのパスワード。

-PWDCrypt encryptedPwd

-UIDオプションに指定したユーザーの暗号化されたパスワード。

-ramLoad

複製処理の完了時に、メモリー内にデータベースを保持します。このオプションによって、大規模なデータベースをコピーする場合にデータベースのアンロードとリロードのサイクルが回避され、複製処理のパフォーマンスが改善されます。複製オプションの後、データベースのRAMポリシーはmanualに設定されます。RAMポリシーをさらに変更するには、ttAdminユーティリティを使用します。

-remoteDaemonPort portNo

リモート・メイン・デーモンのポート番号。
このオプションの引数に指定された値が0(ゼロ)以外の場合、その値をポート番号として使用します。値が0(ゼロ)の場合は、デフォルトの動作を使用してポート番号を決定します。

-remoteDaemonPortオプションは、自動ポート構成を使用しているストアを持つデータベースの複製には使用できません。

-remoteIP remoteIPAddress

使用するリモート/接続先ネットワーク・インタフェースの別名またはIP(IPv4またはIPv6)アドレスを指定します。指定しない場合は、ttRepAdminによって互換性のあるインタフェースが選択されます。

-setMasterRepStart

-duplicateとともに使用した場合、このオプションは、新しく作成されたデータベースのレプリケーション状態を、ネットワーク間でデータベースがコピーされる直前にStart状態に設定します。これにより、複製処理の後にソース・データベースに行われたすべての更新が、新しく複製されたローカル・データベースに確実にレプリケートされます。データベースの不要なトランザクション・ログ・ファイルは削除されます。

-truncate [owner.]table ...| ALL

-duplicate処理中にコピーされたものの、レプリケーション・スキームには含まれていない表を切り捨てます。表がキャッシュ・グループ表の場合には、ttRepAdminはオプションを無視します。

-UID userid

ソース・データベースに対してADMIN権限を持つユーザーのユーザーIDを指定する必要があります。これは内部ユーザーである必要があります。

-verbosity {0 | 1 | 2}

複製処理で実行される通信段階の詳細を表示し、複製の転送の進捗情報をレポートします。
0(デフォルト): 診断は返されません。

1: stdoutに複製パラメータの詳細をレポートします。

2 : 複製パラメータの詳細と、複製の転送処理の詳細をstdoutにレポートします。

例

例3-1 データベースの複製

ソース・データベースで、次のように入力してユーザーを作成し、そのユーザーにADMIN権限を付与します。

CREATE USER ttuser IDENTIFIED BY ttuser;
User created.

GRANT admin TO ttuser;

インスタンス管理者のユーザー名が、複製元と複製先のインスタンスで同じである必要があります。インスタンス管理者としてログインして、server1のds1データベースをds2データベースに複製します。

ttRepAdmin -duplicate -from ds1 -host "server1"
-UID ttuser -PWD ttuser
-connStr "dsn=ds2;UID=ttuser;PWD=ttuser"

例3-2 キャッシュ・グループのあるデータベースの複製

データベースを複製するときにキャッシュ・グループ表を保持するには、-keepCGオプションを使用します。-cacheuidオプションおよび-cachepwdオプションで、キャッシュ管理ユーザーIDおよびパスワードを指定します。キャッシュ管理ユーザーのパスワードを指定しなかった場合は、ttRepAdminからパスワードの入力が求められます。

キャッシュ管理ユーザーIDがorauserで、パスワードがorapwdである場合、host1のデータベースdsn1を複製します。

ttRepAdmin -duplicate -from dsn1 -host host1 -uid ttuser -pwd ttuser
-keepCG -cacheuid orauser -cacheuid orapwd "DSN=dsn2;UID=;PWD="

dsn2のUIDおよびPWDは、インスタンス管理者である現在のオペレーティング・システム・ユーザーとして接続が確立されるように、接続文字列でNULL値として指定されます。インスタンス管理者のみがttRepAdmin -duplicateを実行できます。dsn2がPWDではなくPWDCryptで構成されている場合は、接続文字列がDSN=dsn2;UID=;PWDCrypt=となります。

例3-3 ソース・データベースのレプリケーション状態の設定

-setMasterRepStartオプションによって、srcDataStoreNameデータベースのレプリケーション状態がネットワーク間でコピーされる前にStart状態に設定にされ、メモリー内にデータベースが保持されます。これにより、複製処理後にマスターに対して行われた更新がサブスクライバに確実にコピーできます。

ローカル・ホストをホスト名またはIPアドレスで識別するには、-localhostオプションを使用します。これらのオプションを使用すると、複製処理後にリモート・データベースで行われたすべての更新が、新しく作成またはリストアされたローカル・データベースにレプリケートされます。

ttRepAdmin -duplicate -from srcDataStoreName -host srcDataStoreHost
-setMasterRepStart -ramLoad
-UID timesten_user -PWD timesten_user]
-localhost localHostName
[destDSN | -connStr connectionString ]

注意

このユーティリティでは、データベースに一時表定義は複製できますが、一時表の内容はレプリケートしません。

このユーティリティを使用して、TimesTenのメジャー・リリースをまたいでデータベースを複製することはできません。

更新完了の待機

次の形式のttRepAdminを使用すると、コールが戻る前に、ログ内のすべての更新をすべてのサブスクライバにレプリケートできます。

ttRepAdmin -wait [-name receiverName] [-host receiverHostName]
[-timeout seconds] {DSN | -connStr connectionString}

オプション

ttRepAdmin -waitには、次のオプションがあります。

オプション

説明

DSN

マスター・データベースのデータソース名を示します。

-connStr connection_string

マスター・データベースの接続文字列を指定します。

-wait

レプリケーションがカレントになるまで待機してから続行します。

-name receiverName

データベースを指定します。データベース名は、データベース・パス名の最後の部分です。

-host receiverHostName

サブスクライバ・ホストのホスト名またはTCP/IPアドレスを定義します。

-timeout seconds

タイムアウト値(秒)を指定します。ttRepAdminは、サブスクライバへのすべての更新が完了していない場合でも、この時間内で返されます。

例

ttRepAdmin -wait -name receiverName -host receiverHostName
-timeout seconds -dsn DSN

前述の構文によって、このプログラムの起動時にコミットされたすべての更新がサブスクライバreceiverNameに転送され、このサブスクライバによってそれらのすべての更新がサブスクライバ・データベースで永続コミットされたことが確認されたことを確認する方法が提供されます。タイムアウトで待機時間(秒)が制限されます。

注意:
すべての書込みトランザクション・アクティビティがストアで静止された後にttRepAdmin -waitが起動された場合(アクティブなトランザクションおよび開始済のトランザクションがない状態)、すべての更新がサブスクライバで永続的にコミットされていることを示す確認応答をサブスクライバが送信するまでに、60秒以上かかる可能性があります。

ttRepAdmin -wait -dsn DSN

前述の構文では、タイムアウトおよびサブスクライバ名が指定されていない場合、ttRepAdminは、このプログラムの起動時にコミットされたすべての更新がすべてのサブスクライバに転送され、それらのすべての更新がサブスクライバ・データベースで永続コミットされたことがすべてのサブスクライバによって確認されるまで戻されません。

レプリケーション・ステータス

次の形式のttRepAdminを使用すると、トランザクション・ログ・ファイルのサイズ、ブックマークの位置、またはマスター・データベースのレプリケーション構成を確認できます。

ttRepAdmin -log {DSN | -connStr connectionString}
ttRepAdmin -showstatus {-awtmoninfo} {DSN | -connStr connectionString}
ttRepAdmin -showconfig {DSN | -connStr connectionString}
ttRepAdmin -bookmark {DSN | -connStr connectionString}

オプション

ttRepAdmin監視処理には、次のオプションがあります。

オプション

説明

DSN

マスター・データベースのデータソース名を示します。

-awtmoninfo

AwtMonitorConfigプロシージャをコールして、AWTキャッシュ・グループの監視を有効にした場合は、このオプションを使用して監視結果を表示できます。
AWT監視を有効にした場合、ttrepadmin -awtmoninfoによって次の出力が表示されます。

- TimesTenの処理時間: 監視の有効化以降にAWTトランザクション・データの処理に費やされた合計時間(ミリ秒単位)。

- Oracleブックマークの管理時間: 監視の有効化以降にOracleでのAWTメタデータの管理に費やされた合計時間(ミリ秒単位)。

-connStr connection_string

マスター・データベースの接続文字列を指定します。

-log

他のデータベースに更新を転送するためにレプリケーションによって保持される、トランザクション・ログ・ファイルの数とサイズを表示します。

-showconfig

レプリケーション構成をすべて表示します。
詳細は、『Oracle TimesTen In-Memory Database開発者および管理者ガイド』のレプリケートされたデータベースの構成の表示に関する説明を参照してください。

-showstatus

指定したレプリケートされたデータベースの現在のステータスをレポートします。
詳細は、『Oracle TimesTen In-Memory Database開発者および管理者ガイド』のttRepAdminを使用したレプリケーション・ステータスの表示に関する説明を参照してください。

-bookmark

レプリケーションでログを読み取る必要のある最新のマーカー・レコード、作成された最新のログ順序番号およびレコードがディスクにフラッシュされた最新のログ順序番号をレポートします。
パラレル・レプリケーションを設定している場合、ブックマークはサポートされません。

詳細は、『Oracle TimesTen In-Memory Database開発者および管理者ガイド』のレプリケートされたログ・レコードの表示に関する説明を参照してください。

結果セット

AWT監視を有効にした場合、このユーティリティは他のttRepAdmin -showstatusの出力に加え、次の情報も表示します。

- TimesTenの処理時間: 監視の有効化以降にAWTトランザクション・データの処理に費やされた合計時間(ミリ秒単位)。

- Oracleブックマークの管理時間: 監視の有効化以降にOracleでのAWTメタデータの管理に費やされた合計時間(ミリ秒単位)。

- Oracle実行時間: 監視の有効化以降にAWT SQL処理のOCI準備、バインディングおよび実行に費やされた合計時間(ミリ秒単位)。この統計には、TimesTenとOracle Databaseの間のネットワーク待機時間が含まれます。

- Oracleコミット時間: 監視の有効化以降にOracleに対するAWT更新のコミットに費やされた合計時間(ミリ秒単位)。この統計には、TimesTenとOracle Databaseの間のネットワーク待機時間が含まれます。

- 監視の開始以降の時間。

- TimesTen行処理の合計数: 監視の有効化以降にAWTキャッシュ・グループで更新された行の合計数。

- TimesTenトランザクションの合計数: 監視の有効化以降にAWTキャッシュ・グループで実施されたトランザクションの合計数。

- Oracleへのフラッシュの合計数: TimesTenデータがOracle Databaseに送信された回数の合計。

この他に、TimesTen処理、Oracleブックマーク管理、Oracle実行およびOracleコミットに費やされた時間の割合も出力されます。

例

ttRepAdmin -log DSN

前述の構文によって、他のデータベースに更新を転送するためにレプリケーションで保持されるトランザクション・ログ・ファイルの数がレポートされます。レプリケーション・エージェントは、トランザクション・ログ・ファイル内のすべての更新が各サブスクライバ・データベースに正常に転送されるまでそのトランザクション・ログ・ファイルを保持します。

ttRepAdmin -showconfig DSN

前述の構文によって、レプリケーション構成がすべてレポートされます。指定したDSNのすべてのサブスクライバ、レプリケートされている表の名前と詳細、およびすべてのサブスクリプションが表示されます。

ttRepAdmin -showstatus DSN

前述の構文によって、指定したDSNのデータベースの現在の状態がレポートされます。出力には、レプリケートされたデータベースのレプリケーション・エージェント内のすべてのスレッド、ブックマークの位置、ポート番号および通信プロトコルの状態が含まれます。

ttRepAdmin -bookmark DSN

前述の構文によって、レプリケーションで必要な最も古いログ・レコード、ディスクに書き込まれた最後のログ・レコードおよび最後に生成されたログ・レコードのログ順序番号が出力されます。

ttRepAdmin -showstatus -awtmoninfo myDSN

[other -showstatus output]
...
AWT Monitoring statistics
--------------------------
TimesTen processing time : 0.689000 millisecs (0.164307 %)
Oracle bookmark management time : 3.229000 millisecs (0.770027%)
Oracle execute time : 342.908000 millisecs (81.774043 %)
Oracle commit time : 72.450000 millisecs (17.277315 %)
Time since monitoring was started: 8528.641000 millisecs
Cache-connect Operational Stats :
Total Number of TimesTen row operations : 2
Total Number of TimesTen transactions : 2
Total Number of flushes to Oracle : 2

前述の構文および出力によって、AWT監視ステータスが表示されます。

注意

ttRepAdminユーティリティはTimesTen Data Manager DSNでのみサポートされています。TimesTen Client DSNではサポートされていません。

2つ以上のレプリケーション・スキームを指定する場合、または2つ以上のスキームが特定のデータベースを含む場合、-schemeオプションを使用する必要があります。

SQLの構成を使用すると、同じデータベースに複数のレプリケーション・スキームを作成できます。レプリケーション・スキームが1つしかない場合、ttRepAdminユーティリティは、自動的にスキームを検出します。2つ以上のスキームがある場合は、ttRepAdmin -schemeオプションを使用して、使用するスキームを指定する必要があります。

異なるホスト上の同じ名前のデータベースにレプリケーションを構成する場合、-hostを使用して、どのデータベースを処理するのかを指示できます。たとえば、すべてのサブスクライバがDATAという名前を持つ場合、ホストSW1のレプリケーション状態を設定するには、次のように実行します。

ttRepAdmin -receiver -name DATA -host SW1 -state start DSN

関連項目

TimesTenレプリケーションの詳細は、『Oracle TimesTen In-Memory Database開発者および管理者ガイド』を参照してください。
アップグレードの例は、『Oracle TimesTen In-Memory Databaseインストレーション・ガイド』のTimesTenのアップグレードに関する説明を参照してください。

ttRestore

説明

ttBackupユーティリティを使用して作成されたバックアップからデータベースを作成します。データベースが存在する場合は、ttRestoreはデータベースを上書きしません。

ttRestoreの接続文字列中の属性には、初期接続属性または一般接続属性を使用できます。また、データ・ストア属性のLogDirも使用できます。その他のすべてのデータ・ストア属性は、バックアップ・ファイルからコピーされます。LogDir属性を使用すると、リストアされたデータベースを再配置できます。

ttRestoreによる操作は、データベースを移動させることができるため、初期接続よりも強力です。ただし、他のデータ・ストア属性(LogDir属性を除く)を上書きできないため、データベースの新規作成ほど強力ではありません。

TimesTenのバックアップとリストア機能の概要は、『Oracle TimesTen In-Memory Databaseインストレーション・ガイド』の移行、バックアップおよびリストアに関する説明を参照してください。

必要な権限

このユーティリティには、インスタンス管理者の権限が必要です。

構文

ttRestore {-h | -help | -?}
ttRestore {-V | -version}
ttRestore [-fname filePrefix] [-noconn] -dir directory
{DSN | -connStr connectionString}
ttRestore -i [-noconn] {DSN | -connStr connection_String}

オプション

ttRestoreには、次のオプションがあります。

オプション

説明

-connStr connection_string

データベース名、サーバー名とDSN(必要に応じて)および関連する接続属性を含むODBC接続文字列。

DSN

管理するデータベースのODBCデータソース名を指定します。

-dir directory

バックアップ・ファイルが保存されているディレクトリを指定します。

-fname filePrefix

バックアップ・ディレクトリのバックアップ・ファイルのファイル接頭辞を指定します。バックアップ・ファイルは、この接頭辞を使用してバックアップ・ディレクトリに保存される必要があります。
このパラメータのデフォルト値は、データベースのODBC定義のDataStoreパラメータのファイル名の部分です。

-h
-help

-?

使用方法のメッセージを出力して終了します。

-i

バックアップ・データの標準入力を読み取ります。-dirまたは-fnameオプションは、-iと組み合せて使用できません。

-noconn

リストアが成功したことを確認するために、最後の手順としてttRestoreはデータベースに接続します。このオプションは、この最後の接続を無効にします。最大限のパフォーマンスを得るためには、このオプションを指定することを推奨します。このオプションを指定しない場合、データベースはメモリーにロードされ、メモリーからアンロードされます。

-V | -version

ttRestoreのリリース番号を出力し、終了します。

例

ttRestore -dir /users/pat/TimesTen/backups
-fname FastInsBkup FastIns

origDSNというデータベースをディレクトリ/users/rob/tmpにバックアップし、それをrestoredDSNというデータベースにリストアするには、次のコマンドを実行します。

ttBackup -dir /users/rob/tmp -fname restored origDSN
ttRestore -dir /users/rob/tmp -fname restored restoredDSN

fnameの値は、バックアップ・ファイル名の接頭辞部分に使用する名前です。

UNIXでテープ・バックアップをFastInsデータベースにリストアするには、次のように実行します。

dd bs=64k if=/dev/rmt0 | ttRestore -i FastIns

注意

ttBackupユーティリティおよびttRestoreユーティリティは、TimesTenリリース番号とプラットフォーム番号の最初の3つの数字が同じ場合にのみ、データベースのバックアップおよびリストアを行います。たとえば、リリース11.2.2.2.0と11.2.2.3.0間ではファイルをバックアップし、リストアできます。リリース11.2.1.9.0と11.2.2.3.0の間ではファイルのバックアップとリストアはできません。ttBulkcpユーティリティまたはttMigrateCSユーティリティ(UNIXのみ)を使用して、各主要リリースまたは各種オペレーティング・システムにわたってデータベースを移行できます。ttMigrateをttMigrateCS (ttMigrateのクライアント・サーバー・バージョン)とともに使用して、32ビットと64ビットのプラットフォームまたはビット・レベル間でデータベースを移行できます。新しいビット・レベルでデータをリストアする場合、-relaxedUpgradeオプションを使用する必要があります。ビット・レベルを変更する場合、レプリケーション・スキームにデータベースを含めることはできません。『Oracle TimesTen In-Memory Databaseインストレーション・ガイド』の32ビット・プラットフォームと64ビット・プラットフォーム間のデータベースの移動に関する項の例に従います。

キャッシュ・グループを含むデータベースは、ttBackupユーティリティを使用してバックアップできます。ただし、そのようなバックアップをリストアする場合は、キャッシュ・グループ内のリストアされたデータが古くなっていたり、バックエンドOracle Databaseのデータと同期していないことがあるため、特別な注意が必要です。詳細は、『Oracle TimesTen Application-Tier Database Cacheユーザーズ・ガイド』のキャッシュ・グループを持つデータベースのバックアップとリストアに関する説明を参照してください。

関連項目

ttBackup
ttBulkCp
ttMigrate

ttSchema

説明

データベースのスキーマまたは選択されたオブジェクトを出力します。このユーティリティは、SQL CREATE文で使用される次のスキーマ・オブジェクトを表示できます。

- 表

- 索引

- キャッシュ・グループ定義

- 順序

- ビュー

- マテリアライズド・ビュー・ログ

- パーティション情報などの列の定義

- PL/SQLプログラム・ユニット

表示される詳細のレベルおよびオブジェクトは、オプションを使用して制御できます。出力は、データベースがALTER文などにより現在の状態に達するまでの履歴ではなく、ある時点のデータベースの状態のスナップショットを表しています。データベース全体(データを含む)は、ttSchemaの出力から完全に再作成することはできません。ttIsqlユーティリティでは、データベースの全スキーマを再作成するために、ttSchemaの出力を再生できます。

UNIXでは、このユーティリティはTimesTen Data Manager DSNで使用できます。TimesTenクライアントDSNでは、ttSchemaCSユーティリティを使用します。

必要な権限

このユーティリティを使用するには、データベース・オブジェクトに対して記述操作を実行するために必要な権限があれば十分です。それ以上の権限は必要ありません。

このユーティリティは、その実行者であるユーザーが所有するオブジェクトおよび所有者がSELECT権限を持っているオブジェクトについてのみ情報を出力します。ユーティリティを実行している所有者がADMIN権限を持っている場合には、ttSchemaによってすべてのオブジェクトについて情報が出力されます。

構文

ttSchema {-h | -help | -?}
ttSchema {-V | -version}
ttSchema [-l] [-c] [-fixedTypes] [-st | -systemTables]
[ -list {all | tables | views | sequences |
cachegroups | repschemes |synonyms | plsql} [,...] ]
[-plsqlAttrs | -noplsqlAttrs]
[-plsqlCreate |-[no]plsqlCreateOrReplace]
{-connStr connection_string | DSN }
[[owner.]object_name][...]

オプション

ttSchemaには、次のオプションがあります。

オプション

説明

-connStr connection_string

データベース名、サーバー名とDSN(必要に応じて)および関連する接続属性を含むODBC接続文字列。

-c

互換性モード。TimesTen固有およびリリース固有のキーワードと拡張子の使用を制限します。このことは、ttSchemaの出力が、TimesTenの以前のリリースまたはOracle Databaseのような他のデータベース・システムへの入力として使用されている場合に役立つ可能性があります。
-cオプションを使用すると、INLINEキーワードおよびNOT INLINEキーワードが出力されるのを回避できます。

DSN

スキーマの取得元となるデータベースのODBCデータソース名を指定します。

-fixedTypes

TypeModeの現在の値にかかわらず、完全修飾データ型名を使用します。

-h
-help

-?

使用方法のメッセージを出力して終了します。

-l

データベースのオブジェクトを1行に1項目ずつ表示します。

-list {all | tables | views | sequences | cachegroups | repschemes |synonyms | plsql}[,...]

生成するオブジェクトのカンマ区切り(カンマの後にスペースなし)リスト。指定されたタイプのオブジェクトのみを表示します。デフォルトは、-list allです。
また、-list viewsは、マテリアライズド・ビュー・ログに関する情報も表示します。

[owner.]object_name

出力の有効範囲を、指定したデータベース・オブジェクトに制限します。

-plsqlAttrs |-noplsqlAttrs

ttSchemaがPL/SQLプログラム・ユニットに対してCREATE文とともにALTER SESSION文を発行するかどうかを制御します。
-plsqlAttrsを指定した場合、ttSchemaはCREATE文を発行する前にALTER SESSION文を発行して、これらの属性を設定します。ttSchemaからのこの出力をttIsql(またはsqlplus)にフィードバックして、元のデータベースに指定したのと同じコンパイラ・オプションを指定して、同じプロシージャを作成できます(デフォルト)。

-noplsqlAttrsを指定した場合は、CREATE文のみを生成します。

-plsqlCreate | -[no]plsqlCreateOrReplace

-plsqlCreateを指定した場合、ttSchemaはPL/SQLプログラム・ユニットに対してCREATE PROCEDURE文、CREATE PACKAGE文またはCREATE FUNCTION文を発行します。
-plsqlCreateOrReplace(デフォルト)を指定した場合、ttSchemaはCREATE文またはREPLACE文を発行します。

-st | -systemTables

システム表を含めます。デフォルトではシステム表は省略されます。

-V | -version

ttSchemaのリリース番号を出力し、終了します。

例

orderdsnデータベースのオブジェクトを作成するには、次のSQL文を使用します。

CREATE TABLE ttuser.customer (
cust_num            INTEGER NOT NULL PRIMARY KEY,
region            CHAR(2) NOT NULL,
name              VARCHAR2(80),
address           VARCHAR2(255) NOT NULL);

CREATE SEQUENCE ttuser.custid MINVALUE 1 MAXVALUE 1000000;

CREATE TABLE ttuser.orders (
ord_num INTEGER NOT NULL PRIMARY KEY,
cust_num INTEGER NOT NULL,
when_placed  TIMESTAMP NOT NULL,
when_shipped TIMESTAMP,
FOREIGN KEY(cust_num) REFERENCES ttuser.customer (cust_num));

CREATE MATERIALIZED VIEW ttuser.order_summary AS
SELECT cust.name, ord.ord_num, count(*) ord_count
FROM ttuser.orders ord, ttuser.customer cust
WHERE ord.cust_num = cust.cust_num
GROUP BY cust.name, ord.ord_num;

例3-4 データベースに対するttSchema

orderdsnデータベースのスキーマを返します。

% ttSchema orderdsn
-- Database is in Oracle type mode
create table TTUSER.CUSTOMER (
CUST_NUM NUMBER(38) NOT NULL,
REGION   CHAR(2 BYTE) NOT NULL,
"NAME"   VARCHAR2(80 BYTE) INLINE NOT NULL,
ADDRESS  VARCHAR2(255 BYTE) NOT INLINE NOT NULL,
primary key (CUST_NUM));

create table TTUSER.ORDERS (
ORD_NUM      NUMBER(38) NOT NULL,
CUST_NUM     NUMBER(38) NOT NULL,
WHEN_PLACED  TIMESTAMP(6) NOT NULL,
WHEN_SHIPPED TIMESTAMP(6),
primary key (ORD_NUM),
foreign key (CUST_NUM) references TTUSER.CUSTOMER (CUST_NUM));

create sequence TTUSER.CUSTID
increment by 1
minvalue 1
maxvalue 1000000
start with 1
cache 20;

create materialized view TTUSER.ORDER_SUMMERY as
SELECT CUST.NAME "NAME", ORD.ORD_NUM "ORD_NUM", COUNT(*) "ORD_COUNT"
FROM TTUSER.ORDERS ORD, TTUSER.CUSTOMER CUST WHERE ORD.CUST_NUM =
CUST.CUST_NUM GROUP BY CUST.NAME, ORD.ORD_NUM ;

例3-5 特定のオブジェクトのリスト表示

マテリアライズド・ビューのみとorderdsnデータベースの順序を返します。

% ttSchema -list views,sequences orderdsn
-- Database is in Oracle type mode
create sequence TTUSER.CUSTID
increment by 1
minvalue 1
maxvalue 1000000
start with 1
cache 20;

create materialized view TTUSER.ORDER_SUMMERY as
SELECT CUST.NAME "NAME", ORD.ORD_NUM "ORD_NUM", COUNT(*) "ORD_COUNT"
FROM TTUSER.ORDERS ORD, TTUSER.CUSTOMER CUST WHERE ORD.CUST_NUM =
CUST.CUST_NUM GROUP BY CUST.NAME, ORD.ORD_NUM ;

例3-6 オブジェクトの指定

orderdsnデータベースのorders表のスキーマ情報を返します。

% ttSchema orderdsn ttuser.orders
-- Database is in Oracle type mode
Warning: tables may not be printed in an order that can satisfy foreign key
reference constraints
create table TTUSER.ORDERS (
ORD_NUM      NUMBER(38) NOT NULL,
CUST_NUM     NUMBER(38) NOT NULL,
WHEN_PLACED  TIMESTAMP(6) NOT NULL,
WHEN_SHIPPED TIMESTAMP(6),
primary key (ORD_NUM),
foreign key (CUST_NUM) references TTUSER.CUSTOMER (CUST_NUM));

例3-7 固定データ型の指定

固定データ型名を使用して、orderdsnデータベースのスキーマ情報を返します。

% ttSchema -fixedTypes orderdsn
-- Database is in Oracle type mode
create table TTUSER.CUSTOMER (
CUST_NUM NUMBER(38) NOT NULL,
REGION   ORA_CHAR(2 BYTE) NOT NULL,
"NAME"   ORA_VARCHAR2(80 BYTE) INLINE NOT NULL,
ADDRESS  ORA_VARCHAR2(255 BYTE) NOT INLINE NOT NULL,
primary key (CUST_NUM));

create table TTUSER.ORDERS (
ORD_NUM      NUMBER(38) NOT NULL,
CUST_NUM     NUMBER(38) NOT NULL,
WHEN_PLACED  ORA_TIMESTAMP(6) NOT NULL,
WHEN_SHIPPED ORA_TIMESTAMP(6),
primary key (ORD_NUM),
foreign key (CUST_NUM) references TTUSER.CUSTOMER (CUST_NUM));

create sequence TTUSER.CUSTID
increment by 1
minvalue 1
maxvalue 1000000
start with 1
cache 20;

create materialized view TTUSER.ORDER_SUMMERY as
SELECT CUST.NAME "NAME", ORD.ORD_NUM "ORD_NUM",
COUNT(*) "ORD_COUNT" FROM TTUSER.ORDERS ORD, TTUSER.CUSTOMER CUST
WHERE ORD.CUST_NUM = CUST.CUST_NUM
GROUP BY CUST.NAME, ORD.ORD_NUM ;

注意

生成されたSQLでは、ALTER文による変換履歴は生成されません。また、出力には表のパーティションに関する情報がSQLコメントの形式で示されますが、表のパーティションは保持されません。ttSchemaユーティリティは、初期パーティションにない列のパーティション番号を出力します。初期パーティションは0のため、ttSchemaで出力されるパーティション1は2番目のパーティション1で、初期パーティションではありません。パーティションの詳細は、『Oracle TimesTen In-Memory Database SQLリファレンス』のALTER TABLEに関する説明のALTER TABLEを使用する場合のパーティションの理解に関する説明を参照してください。

このユーティリティでは、0以外の値を指定したPassThrough接続属性はサポートされていないため、0以外の値を指定するとエラーが返されます。

出力に、TimesTenの以前のリリースによって認識されるDDLと互換性があることは保証できません。

アプリケーションのロックの競合問題を回避するために、ttSchema実行中はDDL SQLを実行しないことをお薦めします。

ttSize

説明

指定した表(データベース内のビューを含む)にrows行が追加されて、サイズが大きくなったときの領域の消費量を見積もります。このユーティリティは既存の表に対して使用したり、表の作成時に表サイズを見積もる場合に使用できます。所有者を指定しない場合、ttSizeは指定された表名のすべての表についてのサイズ情報を出力します。サイズ情報には、表に定義された索引によって占有される領域が含まれています。

可変長列に必要なメモリーは、最終的な表の列の平均長として、現在の表の列の平均長を使用して見積もります。現在の表に行がまったく存在しない場合、ttSizeは、平均列長を最大列長の半分であると推定します。

LOB列に必要なメモリーは、最終的な表の列の平均長として、現在の表の列の平均長を使用して見積もります。表に行が挿入されない場合、計算にLOB列は含まれません。

このユーティリティをコールすると表がスキャンされます。オプションのNULL以外のfrac値(0と1の間)を指定することによって、表のスキャンを回避します。ttSizeユーティリティはこの値を使用して、可変長列の平均サイズを見積もります。fracを各可変長列の最大サイズに掛けて、VARBINARY列またはVARCHAR列の推定平均サイズを計算します。fracオプションを指定しないと、表内の既存の行がスキャンされ、既存の行における可変長列の平均長が使用されます。fracを指定しなかった場合、表に行が存在しないと、fracの値は0.5であると想定されます。

必要な権限

このユーティリティを使用するには、指定のデータベース・オブジェクトに対してSELECT操作を実行するために必要な権限があれば十分です。それ以上の権限は必要ありません。

構文

ttSize {-h | -help | -?}
ttSize {-V | -version}
ttSize -tbl [owner.]tableName [-rows rows] [- frac fraction]
{-connStr connection_string | DSN}

オプション

ttSizeには、次のオプションがあります。

オプション

説明

-connStr connection_string

データベース名、サーバー名とDSN(必要に応じて)および関連する接続属性を含むODBC接続文字列。

DSN

ttSizeが表の情報を検索するために接続するデータソースの名前を指定します。

-frac frac

使用されるVARCHARまたはVARBINARYの表外の列のサイズの推定平均端数を指定します。このオプションが省略され、表に表外の可変サイズの列が含まれる場合、平均サイズを求めるために表スキャンが行われます。表が空の場合には、端数に0.5 (50%)が埋められていると推定されます。

-h
-help

-?

使用方法のメッセージを出力して終了します。

-tbl [owner.]tableName

サイズの見積りに定義が使用される表の名前を指定します。所有者を省略すると、ユーザーのログイン名として試行されます。見つからない場合には、ユーザーSYSが使用されます。

-rows rows

表内の予想される行数を指定します。TimesTenの表を保存するために必要な領域には、実データのための領域に加え、ブックキーピング、動的メモリー割当ておよび索引のオーバーヘッドが含まれています。
メモリーの断片化、問合せの実行中に割り当てられる一時領域、およびコンパイルされたSQL文を保持するための領域が原因で、TimesTenは追加の領域を消費する可能性があります。

このオプションを省略すると、ttSizeユーティリティは既存の表の行数を使用して表領域を見積もり、表が空の場合は1行を使用します。

-V | -version

ttSizeのリリース番号を出力し、終了します。

例

表に必要な領域を推定するには、TimesTenで表を作成し、代表的な行のサンプルをその表に移入し、必要な索引を作成し、それらの定義でttSizeを実行します。たとえば、200,000行まで大きくなったときのデータソースFixedDsのNAMEIDのサイズを見積もるには、次のコマンドを実行します。

ttSize -tbl Nameid -rows 200000 FixedDs

Rows = 200000

Total in-line row bytes = 7139428

Total = 7139428

注意

サイズ要件の見積り、および断片化の測定を行う別の方法には、MONITOR表を使用する方法があります。Oracle TimesTen In-Memory Databaseのシステム表およびビューについてのマニュアルのSYS.MONITORに関する説明を参照してください。

表に行が挿入されない場合を除いて、LOB列は可変長型の列と同様に扱われます。表に行が挿入されない場合は、平均サイズの計算にLOB列は含まれません。

PERM_ALLOCATED_SIZEおよびPERM_IN_USE_SIZEは、現在割り当てられているデータベースのサイズ(単位はKB)および使用中のデータベースのサイズを示します。接続を確立または解放するたびに、またトランザクションがコミットまたはロールバックされるたびに、この情報はシステムによって更新されます。

このユーティリティはTimesTen Data Manager DSNでのみ使用できます。TimesTen Client DSNではサポートされていません。

ttStats

説明

ttStatsユーティリティでは、データベース・メトリック(統計、状態およびその他の情報)を監視し、メトリックのスナップショットを取得して比較します。このユーティリティでは次のことができます。

- データベースのパフォーマンス・メトリックをそれぞれの前の間隔での変更率を計算することにより、リアルタイムで監視および表示します。

- メトリックのスナップショットを収集してデータベースに保存し、指定されたスナップショットのペアの値と変更率を使用してレポートを生成します。(これらの機能は、TT_STATS PL/SQLパッケージへのコールにより実行されます。)

TimesTenはTimesTenシステム表、ビューおよび組込みプロシージャからメトリックを収集します。レポートには、メモリー使用量、接続およびロード・プロファイルの概要などの情報に続き(必要に応じて)SQL文、トランザクション、PL/SQLメモリー、レプリケーション、ログとログの保持、チェックポイント、キャッシュ・グループ、キャッシュ・グリッド、ラッチ、ロック、XLAおよびTimesTen接続属性に関するメトリックが含められます。監視では、この項で後述するように、キーとなる小セットのデータが表示されます。

クライアントDSNに対しては、ユーティリティのttStatsCS (UNIXまたはWindows)を使用してください。

動作モードには次の3つがあります。

- モニター・モード(デフォルトのモード): 定義済のメトリックのセットを監視することによってデータベースのパフォーマンスをリアルタイムで追跡し、それらのメトリックを(前回の表示から値に変更のあったものをメインで)表示し、適切な場合値の変更率を算出します。情報はユーザーに対する表示のための標準出力に出力され、ディスクには保存されません。
期間または反復回数が指定されない場合、[Ctrl]キーを押しながら[C]キーを押すことにより実行が中断されるまで、監視は実行されます。

注意:
モニター・モードで表示されるメトリックのセットは、メトリックが収集されたシステム表および組込みプロシージャへの変更により、変更されることがあります。

- スナップショット・モード: 取得レベルに応じてメトリックのスナップショットを取得し、それらをデータベースのSYS.SNAPSHOT_XXXXシステム表に保存します。スナップショットが取得されると、そのID番号が標準出力に表示されます。取得レベルはSYS.SYSTEMSTATSからのメトリックに対してのみ適用されます。他のソースからのメトリックについては、取得レベルにかかわらず同じデータが収集されます。
デフォルトでは、多くの目的に適した一般的なメトリックのセットが収集されますが、数の少ない基本的なメトリックのセット、すべての使用可能なメトリックまたはSYSTEMSTATS以外のソースからのメトリックのみも指定できます。

- レポート・モード: 指定した2つのメトリックのスナップショットからレポートを生成します。レポートはデフォルトでHTML形式ですが、プレーン・テキスト形式を要求することもできます。出力ファイルを指定することも、標準出力に出力を表示することもできます。ttStatsレポートは、Oracle Databaseのパフォーマンス分析ツールに例えた場合、Oracle Automatic Workload Repository (AWR)レポートに類似しています。

モニター・モードでは、データベースからの読取りによるオーバーヘッドは回避されます。スナップショット・モードおよびレポート・モードでは、ttStatsユーティリティはTimesTenで提供されるTT_STATS PL/SQLパッケージに対する便利なフロント・エンドとなります。このパッケージの詳細は、『Oracle TimesTen In-Memory Database PL/SQLパッケージ・リファレンス』のTT_STATSに関する説明を参照してください。

注意:
ttStatsユーティリティには、次の依存および制限があります。

- モニター・モードでは、TimesTenリリース11.2.2.4.0のSYS.SYSTEMSTATS表に追加された機能が必要になります。

- スナップショット・モードおよびレポート・モードでは、TimesTenリリース11.2.2.5.0で追加されたTT_STATS PL/SQLパッケージが必要になります。

- ドライバ・マネージャを介してTimesTenに接続している場合には、このユーティリティは使用できません。

スナップショットは、TimesTenの複数のSYS.SNAPSHOT_xxxxxシステム表に格納されます。(これらの表のリストは、『Oracle TimesTen In-Memory Databaseシステム表およびビュー・リファレンス』の内部的な使用または将来の使用のために予約された表またはビューに関する説明を参照してください。)

前述の組込みプロシージャおよびそれらが収集するデータの詳細は、第2章「組込みプロシージャ」を参照してください。

必要な権限

- モニター・モード: モニター・モードを実行するには特別な権限は必要ありませんが、ttSQLCmdCacheInfo組込みプロシージャおよびtransaction_log_api (XLA)表からのデータを含める監視情報には、ADMIN権限が必要です。

- スナップショット・モードおよびレポート・モード: デフォルトで、TT_STATS PL/SQLパッケージのセキュリティ制限のため、インスタンス管理者のみがスナップショット・モードまたはレポート・モードで実行する権限があります。ADMINユーザーを含む他のユーザーは、次の例に示すように、インスタンス管理者またはADMINユーザーによってTT_STATSパッケージに対するEXECUTE権限を付与される必要があります。

GRANT EXECUTE ON SYS.TT_STATS TO scott;

構文

ttStats [-h | -help]
ttStats [-V | -version]
ttStats [-monitor] [-interval seconds]
[-duration seconds] [-iterations count]
{DSN | -connStr connectionString}
ttStats  -snapshot [-level capture_level] [-notes snap_desc]
{DSN | -connStr connectionString}
ttStats  -report [-snap1 snapid1 -snap2 snapid2]
[-html | -text] [-outputFile filename]
{DSN | -connStr connectionString}

注意:
-monitor、-snapshotまたは-reportのいずれか1つのみを指定します。

オプション

ttStatsには次のオプションがあります。

オプション

説明

-h
-help

オプションのリストを出力し終了します。
注意: ttStatsコマンドラインで何も入力されなかった場合、またはオプションがDSNまたは接続文字列なしで入力された場合も同じ結果です。

-V
-version

TimesTenのリリース番号を出力し終了します。

-monitor

リアルタイムのモニター・モードを実行します。定義済のメトリックのセットを監視し、メトリックおよび変更率を繰り返し表示します。スナップショット・モードとは異なり、データベースには何も保存されません。
注意: これは-monitor、-snapshotまたは-reportのいずれも指定されない場合のデフォルトのモードです。

-interval seconds

モニター・モードでは、これは表示されるメトリックのセット間の時間間隔(秒)です。デフォルトは10秒です。間隔が短いとシステムのパフォーマンスにマイナスの影響を与える場合があります。

-duration seconds

モニター・モードでは、これはttStatsを実行する継続時間(秒)です。この継続時間後に、ユーティリティは終了します。
-iterationsオプションについての情報も参照してください。

-iterations count

モニター・モードでは、これはttStatsがメトリックの収集および表示を実行する反復の回数です。これらの回数の反復後に、ユーティリティは終了します。
注意: -durationと-iterationsの両方を指定した場合、2つの制限のうち最初の制限に到達した際に監視は終了します。どちらも指定しない場合、[Ctrl]キーを押しながら[C]キーを押すことによって中断されるまで監視は継続します。

-snapshot

メトリックのスナップショットを取得レベルに応じて収集し、それらのメトリックをデータベースに保存します。スナップショットが取得されると、そのID番号が表示されます。
注意:

- TimesTenでは、スナップショットの取得時にすべてのSYSTEMSTATSが収集されますが、指定された取得レベル内のメトリックのみが意味のある累積値を持ちます。指定のレベル以外のメトリックは、0 (ゼロ)の値になります。

- このオプションは、TT_STATS PL/SQLパッケージのCAPTURE_SNAPSHOTプロシージャへのコールにより実行されます。

-level capture_level

スナップショット・モードでは、これは取得するメトリックのレベルです。次の設定が可能です。

- 0: SYS.SYSTEMSTATS以外のメトリックのみ。

- 1: 基本的なメトリックのみ。

- 2 (デフォルト): 一般的なメトリック。これには、基本的なメトリックが含まれます。このレベルは、ほとんどの場合に適しています。

- 3: 使用可能なすべてのメトリック。

レポートで任意の2つのスナップショットを使用する場合は、各スナップショットに同じレベルを使用します。

注意:

- これらのレベルは、TT_STATS PL/SQLパッケージの取得レベルNONE、BASIC、TYPICALおよびALLに対応します。

- 取得レベルはSYS.SYSTEMSTATS表からのメトリックに対してのみ適用されます。他のソースからのメトリックについては、取得レベルにかかわらず同じデータが収集されます。

-notes snap_desc

スナップショット・モードで、他のスナップショットと区別するなどスナップショットに説明または注意を付与するには、このオプションを任意で使用します。

-report

指定した2つのスナップショットから、デフォルトでHTML形式でレポートを生成します。同じ取得レベルで取得されるスナップショットを使用します。
注意:

- スナップショットIDを指定しない場合、使用可能なスナップショットの(日付、時間、取得レベル、注意書きの付いた)リストが表示され、使用する各IDを入力するようプロンプト表示されます。スナップショットIDを1つのみ指定した場合、コマンドを2つ入力するように指示されます。この場合、2つのスナップショットを指定して再度コマンドを入力します。

- このオプションは、TT_STATS PL/SQLパッケージのGENERATE_REPORT_HTMLまたはGENERATE_REPORT_TEXT (-textオプションが使用された場合)プロシージャへのコールにより実行されます。

-snap1 snapid1

レポート・モードにおいて、これは1つ目のスナップショットのスナップショットIDです。

-snap2 snapid2

レポート・モードにおいて、これは2つ目のスナップショットのスナップショットIDです。

-outputFile filename

レポート・モードにおいて、レポートが書き込まれるファイル・パスおよびファイル名を任意で指定します。ファイルが指定されていない場合、TimesTenはレポートを標準出力に書き込みます。

-html | -text

レポート・モードにおいて、HTMLまたはプレーン・テキストの出力形式を指定します。
注意: -htmlを指定する必要はありません。形式を指定しない場合には、レポートは、デフォルトでHTML形式になります。

-connStr connstring
または

DSN

メトリックを収集するデータベースを指定し接続します。次のいずれかを行います。

- -connStrを前に付けてODBC接続文字列を指定します。

- -connStrを付けずに、コマンドラインの最後にDSN(データ・ソース名)を指定します。

TimesTen DSNの詳細は、『Oracle TimesTen In-Memory Databaseオペレーション・ガイド』のTimesTenデータベースを識別するためのデータ・ソース名の指定方法に関する説明を参照してください。

例

この項では、ttStatsの監視およびレポート出力の例を紹介します。

注意:
これらの例は一例にすぎません。詳細は変更される場合があります。

監視の例

この項では、モニター・モードからのサンプル出力を示します。

% ttStats sampledb_1122

Connected to TimesTen Version 11.02.02.0005 TimesTen Cache version 11.2.2.5.0.

Waiting for 10 seconds for the next snapshot
Description                          Current  Rate/Sec  Notes
date.2012-Dec-20 16:49:25      -869676175380467200           1  sample #, not rate
connections.count                         12
db.size.temp_high_water_mark.kb         7153       7
lock.locks_granted.immediate             832       1
log.log_bytes_per_transaction              0
loghold.bookmark.log_force_lsn    0/12027904
loghold.bookmark.log_write_lsn    0/12050944
loghold.checkpoint_hold_lsn       0/12025856                  sampledb_1122.ds0
loghold.checkpoint_hold_lsn       0/12023808                  sampledb_1122.ds1
stmt.executes.count                       44       1
stmt.executes.selects                     32       1

注意:
日付および時刻の後の数値はスナップショットの時刻の数値表現であり、無視できます。

次のコマンドライン例では、監視は2回の反復後に停止し、接続属性値の設定に接続文字列を使用することを指定しています。

% ttStats -iterations 2
-connStr "DSN=sampledb_1122;PLSQL_MEMORY_ADDRESS=20000000"

スナップショット例

次の例では、デフォルトの一般的レベルで2つのスナップショットを取得します。

% ttStats -snapshot sampledb_1122

Connected to TimesTen Version 11.02.02.0005 TimesTen Cache version
11.2.2.5.0.
Snapshot 1 at TYPICAL level was successfully captured.

% ttStats -snapshot sampledb_1122

Connected to TimesTen Version 11.02.02.0005 TimesTen Cache version
11.2.2.5.0.
Snapshot 2 at TYPICAL level was successfully captured.

レポート例

次の例では、前の項で生成したスナップショットからレポートを作成します。

% ttStats -report -outputFile testreport.html -snap1 1 -snap2 2 sampledb_1122

Connected to TimesTen Version 11.02.02.0005 TimesTen Cache version
11.2.2.5.0.
Report testreport.html was created.

この項の以降の説明では、ttStatsレポートが生成するメトリックの表からの引用を紹介します。この出力は、デフォルトのHTML形式を使用して生成されたものです。

注意:
SWTキャッシュ・グループ・メトリック、ローカル・キャッシュ・グループ・メトリック、動的グローバル・キャッシュ・グループ・メトリック、グリッド・メトリックおよびラッチ・メトリックについての例は示されていません。
ラッチ・メトリックを含むには、次のようにttXactAdminユーティリティを使用して、データベースでラッチ・メトリックを有効にする必要があります。

% ttXactAdmin -latchstats on DSN

サマリー 　図3-1はレポート・サマリーの大部分を示しています。サマリーは、次に続く表に詳細が記されており、データベース・メトリックをすばやく確認するのに適しています。内容は次のとおりです。

- メモリーの使用率と接続: この情報にはメモリー使用率(db.sizeメトリック)、およびクライアント/サーバー接続と直接接続の数を含む確立された接続(connections.establishedメトリック)についての情報が含まれます。connections.established.threshold_exceededの値がゼロでない場合には、接続が多すぎることを示しています。

- ロード・プロファイル: チェックポイント、ソート(ORDER BY文など)、ログ・バッファ待機(ログ・バッファが一杯になり、ディスクにフラッシュするときの遅延)、挿入、更新、削除、解析(準備など)、コミットおよびロールバックなどの数を示し、ワークロードの概念を示します。解析が多すぎるか、永続コミット(非永続コミットよりも高負荷)が多すぎるかどうかを検討します。

- インスタンス効率: Command Cache Hit %、Non-Parse/Execs %、Lock Hit %およびLog Buffer No Wait %が表示されます。すべてがほぼ100%になる必要があります。

- Lock Hit %: 待機することなく認められたロック要求の割合を推定します。

- Non-Parse/Execs %: 準備または再準備の必要のないSQL文の割合を表します。

- Command Cache Hit %: コマンド・キャッシュで見付からなかったSQLコマンドの実行の割合を推定します。

- Log Buffer No Wait %: ログ・バッファの待機のため、待機する必要のないログ挿入の割合を推定します。

図3-1 ttStatsレポート: サマリー

文統計 　図3-2ではレポートからの文メトリックが示されています。外部メトリック(stmt.executes、stmt.preparesおよびstmt.repreparesメトリック)および増分メトリック(zzinternalメトリック)の両方が示されています。外部メトリックの方が一般的に関心度が高くなります。stmt.executes.countの値は、他のすべてのstmt.executes値の合計となります。

図3-2 ttStatsレポート: 文統計

トランザクション統計　 図3-3ではレポートからのトランザクション・メトリックが示されています。txn.commits.count値は、txn.commits.durableの値とtxn.commits.nondurableの値との合計です。表示されている他のメトリックは、これらのメトリックのサブセットです。

図3-3 ttStatsレポート: トランザクション統計

SQL統計: 実行でソート  図3-4では、レポートのSQL統計部分からのSQL実行メトリックの引用を示しています。「実行でソート」メトリックおよび「準備でソート」メトリック(次の項で示す)を見ると、よく使用される文がどれであるか、準備数、各文の実行回数がわかります。文は何度も準備されないことが理想です。

図3-4 ttStatsレポート: SQL実行統計

SQL統計: 準備でソート  図3-5では、レポートのSQL統計部分からのSQL準備メトリックの引用を示しています。前述の「実行でソート」の項の説明を参照してください。

図3-5 ttStatsレポート: SQL準備統計

SQL統計: コマンド・テキスト  図3-6では、レポートのSQL統計部分からのSQL文の引用を示しています。このレポートは、前述の「実行でソート」および「準備でソート」のレポートにリストされた、各文の完全なテキストを示しています。ここでは長い文は省略されています。

図3-6 ttStatsレポート: SQLコマンド・テキスト

PL/SQLメモリー統計  図3-7ではレポートからのPL/SQLメモリー・メトリックが示されています。これらは、ttPLSQLMemoryStats組込みプロシージャからのメトリックです。GetHitRatioまたはPinHitRatioの開始値と終了値には著しい差はありません。

図3-7 ttStatsレポート: PL/SQLメモリー統計

レプリケーション統計  図3-8ではレポートからのレプリケーション・メトリックが示されています。各トランスミッタに対し(1つのマスターに複数のトランスミッタがある場合もある)、このメトリックはレシーバに送信されたレコード数など、ログを介した進捗を示します。Repl_Peerはサブスクライバを示します。Repl_Log_BehindおよびRepl_Latencyは、レプリケーションがデータベース・ワークロードに対応しているかどうかを示す上で重要です。

図3-8 ttStatsレポート: レプリケーション統計

パラレル・レプリケーション/AWT統計  図3-9ではレポートからのパラレル・レプリケーション/AWT・メトリックが示されています。Repl_Peerはサブスクライバを示します。パラレル・レプリケーション/AWTの構成時に、レプリケーション・メトリック(前項で説明)がワークロードに対応することが難しいことが示された場合、パラレル・レプリケーション/AWTメトリックにより原因を表示できます。各値はすべてのトラックの集計ですが、「詳細の表示」(メトリック表の最後にあります。ここでは図示されていません)をクリックすると、各トラックのデータを表示できます。トラック切替えのswitchinおよびswitchoutメトリックの値が高いと、競合を示している場合があります。waitsメトリックの値が高くても問題があり、あるトランザクションが開始またはコミットできるようになる前に、前のトランザクションがコミットするのを待機しなければならないなどの状況を示しています。

図3-9 ttStatsレポート: パラレル・レプリケーション/AWT統計

ログ統計  図3-10ではレポートからのログ・メトリックが示されています。レポート出力では、log.file.earliestおよびlog.file.latestの数字は、スナップショットの開始および終了の値を示しています。log.buffer.waitsメトリックは、特に関心の高い値です。ログ・バッファ待機は、アプリケーション処理が、トランザクション・データをログ・バッファに挿入できず、停止してログ・バッファ領域が解放されるのを待機する必要があるときに発生します。通常この理由は、ログ・フラッシャ・スレッドが十分な速さでデータをクリアしていなかったためです。これは、ログ・バッファ領域が不十分、ディスク帯域幅が不十分、ディスクへの書込みに時間がかかりすぎる、またはログ・フラッシャがCPUの能力に依存していることを示していることが考えられます。(『Oracle TimesTen In-Memory Databaseオペレーション・ガイド』のトランザクション・ログ・バッファおよびファイルの管理に関する説明およびLogBufMBの増加に関する説明も参照してください。)

図3-10 ttStatsレポート: ログ統計

ログの保持  図3-11ではレポートからのログの保持情報が示されています。ここでは、各チェックポイント・ファイルに対するチェックポイント・ログ保持のブックマーク位置と、各レプリケーション・サブスクライバに対するレプリケーション・ログ保持のブックマーク位置が示されています。また、このレポートではバックアップ、XLA、長時間実行トランザクションについてのログ保持情報も示されることがあります。開始と終了の値が同じ場合には、何も動きがなかったことを示します。

ログ・ファイル全体にわたり、順調に進行した証拠があることが理想です。(この追跡にはttStatsの監視情報がさらに役立ちます。)

図3-11 ttStatsレポート: ログの保持

チェックポイント統計  図3-12ではレポートからのチェックポイント・メトリックが示されています。

図3-12 ttStatsレポート: チェックポイント統計

キャッシュ・グループ統計: AWTキャッシュ・グループ  図3-13ではレポートからのAWTキャッシュ・グループ・メトリックが示されています。値はすべてのAWTキャッシュ・グループから集計されます。情報には、Oracle Databaseへのコール数、Oracleに対するコミット、ロールバックおよび再試行の数、PL/SQL操作およびSQL操作によって挿入、削除および更新された行数が含まれます。

図3-13 ttStatsレポート: AWTキャッシュ・グループ統計

キャッシュ・グループ統計: 自動リフレッシュ・キャッシュ・グループ  図3-14ではレポートからの自動リフレッシュ・キャッシュ・グループ・メトリックが示されています。値はすべての自動リフレッシュ・キャッシュ・グループから集計されます。キャッシュ・グループが完全リフレッシュ・モードであるか増分リフレッシュ・モードであるかは、cg.autorefresh.cycles.completed値(リフレッシュの合計回数)に対するcg.autorefresh.full_refreshes値により反映されます。

図3-14 ttStatsレポート: 自動リフレッシュ・キャッシュ・グループ統計

データベース・アクティビティ統計  図3-15ではレポートからのデータベース・アクティビティ・メトリックが示されています(索引アクティビティ、メモリー・アクティビティ、表アクティビティ)。ハッシュ索引および範囲索引については、削除、挿入、フェッチされた行およびスキャンの情報が含まれます。メモリー使用量については、サイズ・データを示します。表については、読取り、削除、挿入および更新された行を示します。

図3-15 ttStatsレポート: データベース・アクティビティ統計

ロック統計  図3-16ではレポートからのロック・メトリックが示されています。デッドロック、取得したロック、付与されたロック、タイムアウトに関する情報が提供されます。特に、lock.deadlocks、lock.locks_granted.waitおよびlock.timeoutsはロック競合を示すことがあります。

図3-16 ttStatsレポート: ロック統計

XLA情報  図3-17ではレポートからのXLAブックマーク情報が示されています。各ブックマークについて、情報が削除される前のログ・ファイルの場所を示すPurge_LSNおよびXLAトランザクションの位置と最新のログ・ファイルの位置間にずれがないかどうかを示すLog_Behindに対する開始と終了の値が示されます。

図3-17 ttStatsレポート: XLA情報

構成パラメータ  図3-18ではレポートからのデータベース構成パラメータ設定が示されています。参考のため、各レポートには各TimesTen接続属性の開始値および終了値が示されています。

接続属性の詳細は、第1章「接続属性」を参照してください。

図3-18 ttStatsレポート: 構成パラメータ

ttStatus

説明

TimesTenの現在の状態を説明する情報を表示します。コマンドは次の情報を表示します。

- TimesTenデーモン・プロセスとすべてのサブデーモン・プロセスの状態。

- すべての既存のTimesTenデータベースの名前。

- 各TimesTenデータベースに現在接続されている接続数。

- RAM、キャッシュ・エージェントおよびレプリケーション・ポリシー。

- TimesTenキャッシュ・エージェントのステータス。

- PL/SQLのステータス。

- TimesTenが使用する共有メモリー・セグメントのキーおよびアドレス。

- PL/SQLが使用する共有メモリー・セグメントのアドレス、キーおよびID。

- TimesTenインスタンスに指定のオペレーティング・システム・グループがアクセスできるのか、または誰でもアクセスできるのか。詳細は、『Oracle TimesTen In-Memory Databaseオペレーション・ガイド』のTimesTenデーモン・オプションの管理に関する項にあるデーモン・オプションの説明を参照してください。

- その他のステータス情報。

接続文字列またはDSNを指定すると、ttStatusは指定したデータベースの情報のみを出力します。

必要な権限

このプロシージャには、権限は必要ありません。

構文

ttStatus {-h | -help | -?}
ttStatus {-V | -version}
ttStatus [-v] [-r secs] [-[no]pretty]
ttStatus [-r secs] [-[no]pretty] {DSN | -connStr connection_string | dspath}

オプション

ttStatusには、次のオプションがあります。

オプション

説明

-h
-help

-?

使用方法のメッセージを出力して終了します。

-connStr connection_string

データベース名、サーバー名とDSN(必要に応じて)および関連する接続属性を含むODBC接続文字列。

DSN

ステータスを取得するデータベースのODBCデータソース名を示します。

-dsn DSN

ステータスを確認するDSNを指定します。DSNを指定しない場合は、データ・ストアに対するすべての接続のステータスが表示されます。

-[no]pretty

noは、簡潔な書式を使用しないことを示します。デフォルトは、ConnectionName接続属性の値を使用する簡潔な書式です。

-r secs

ttStatusの実行を継続できるようにします。secs秒ごとにステータス・レポートを更新します。

-V | -version

ttStatusのリリース番号を出力し、終了します。

-v

TimesTenカスタマ・サポートに役立つ詳細情報を出力します。

サンプル出力

プロシージャをコールすると、システムの現在の状態を説明するレポートがstdoutに表示されます。cachedb1_1122 DSNの状態を取得するには、次のように実行します。

ttstatus cachedb1_1122

TimesTen status report as of Thu May 02 19:45:43 2013

Daemon pid 5280 port 53392 instance tt1122_32
TimesTen server pid 3940 started on port 53393
------------------------------------------------------------------------
Data store cachedb1_1122
There are 12 connections to the data store
Shared Memory KEY Global\cachedb1_1122.c|. . .HANDLE 0x254
PL/SQL Memory KEY Global\cachedb1_1122.c|. . . HANDLE 0x258 Address 0x5B8C0000
Type            PID     Context     Connection Name              ConnID
Process         5196    0x01066a58  cachedb1_1122                     1
Subdaemon       3912    0x00b2c398  Manager                        2047
Subdaemon       3912    0x00b7e4a0  Rollback                       2046
Subdaemon       3912    0x015d25e8  Flusher                        2045
Subdaemon       3912    0x015e46b0  Monitor                        2044
Subdaemon       3912    0x016767f8  Deadlock Detector              2043
Subdaemon       3912    0x016888c0  Checkpoint                     2041
Subdaemon       3912    0x0d350578  Aging                          2042
Subdaemon       3912    0x0d362640  Log Marker                     2040
Subdaemon       3912    0x0d4347c8  AsyncMV                        2039
Subdaemon       3912    0x0d446890  HistGC                         2038
Subdaemon       3912    0x0d458958  IndexGC                        2037
Replication policy  : Manual
Cache Agent policy  : Manual
PL/SQL enabled.
------------------------------------------------------------------------
Accessible by group . . .
End of report

注意

この情報は、主にTimesTenカスタマ・サポートによる使用を目的としていますが、システム管理者およびシステム開発者に役立つ場合もあります。

このユーティリティは、TimesTen Data Managerがインストールされている場合にのみサポートされます。

ttStatusユーティリティは使用されていない場合、RAMポリシーのみをレポートします。

関連項目

ttAdmin

ttSyslogCheck (UNIX)

説明

システムの/etc/syslog.confファイルがTimesTenに対して適切に構成されているかどうかを確認します。TimesTen Data Managerはsyslogを使用して様々な進捗メッセージを記録します。syslogの構成では、TimesTenが単一のディスク・ファイル内のディスクにすべてのメッセージを書き込むようにすることを強くお薦めします。ttSyslogCheckユーティリティは、syslogの構成(/etc/syslog.confの中)を調べて、TimesTenに対して適切に構成されていることを確認します。

syslogが適切に構成されていると、ttSyslogCheckはTimesTenメッセージが記録されるファイルの名前を表示して、終了コード0で終了します。syslogが適切に構成されていない場合、ttSyslogCheckはエラー・メッセージを表示し、コード1で終了します。

必要な権限

このプロシージャには、権限は必要ありません。

構文

ttSyslogCheck {-h | -help | -?}
ttSyslogCheck {-V | -version}
ttSyslogCheck [-facility name]

オプション

ttSyslogCheckには、次のオプションがあります。

オプション

説明

-h
-help

-?

使用方法のメッセージを出力して終了します。

-facility name

メッセージ・ロギングで使用されるsyslog機能名を指定します。

-V | -version

ttSyslogCheckのリリース番号を出力し、終了します。

注意

このユーティリティは、TimesTen Data Managerがインストールされている場合にのみサポートされます。

ttTail

説明

データベースからTimesTenの内部トレース情報をフェッチして、stdoutに表示します。デフォルトでは、TimesTenはトレース情報を生成しません。詳細は、「ttTraceMon」を参照してください。

必要な権限

このユーティリティには、ADMIN権限が必要です。

構文

ttTail {-h | -help | -?}
ttTail {-V | -version}
ttTail [-f] {-connStr connection_string | DSN}

オプション

ttTailユーティリティは、次のオプションをサポートします。

オプション

説明

-connStr connection_string

データベース名、サーバー名とDSN(必要に応じて)および関連する接続属性を含むODBC接続文字列。

DSN

トレースの取得元となるデータベースのODBCデータソース名を示します。

-f

トレースの最後に達しても、ttTailは処理を終了せずに継続し、定期的にデータベースのトレース・バッファのポーリングを行って追加のTimesTenトレース・レコードを検索して表示します。たとえば、これはリアルタイムで更新されるトレース・データの表示を生成するのに役立ちます。

-h-help
-?

使用方法のメッセージを出力して終了します。

-V | -version

ttTailのリリース番号を出力し、終了します。

例

ttTail MyDatastore

注意

この情報は、主にTimesTenカスタマ・サポートによる使用を目的としていますが、システム管理者およびシステム開発者に役立つ場合もあります。

このユーティリティは、TimesTen Data Managerがインストールされている場合にのみサポートされます。

ttTraceMon

説明

ttTraceMonユーティリティでは、TimesTenの内部トレース機能を有効および無効にできます。

データベースごとにトレース・オプションを有効および無効にできます。各データベースには、TimesTenの内部処理を説明するメッセージを書き込めるトレース・バッファが含まれています。デフォルトでは、トレースは無効になっています。ただし、このユーティリティを使用して有効にできます。

ttTraceMonユーティリティにはサブコマンドがあり、トレース情報を有効、無効、ダンプおよび操作できます。1つのプロンプトに複数のサブコマンドを入力できる対話形式またはttTraceMonコマンドラインに1つのサブコマンドを指定できる非対話形式のいずれかで、ttTraceMonを実行できます。

対話形式で実行する場合、ttTraceMonは標準入力からテキスト行の入力を要求し、その行をトレース・コマンドとして解釈します。セミコロンで区切ることによって、複数のトレース・コマンドを同一の行に指定できます。ttTraceMonを終了するには、空白行を入力します。

対話モードでは、次のようにttTraceMonコマンドの出力をファイルにリダイレクトできます。

ttTraceMon connection_string >filename

コンポーネント名の大/小文字は区別されません。一部のコマンド(dump、showおよびflush)では、複数のコンポーネントを表示することができ、操作は各コンポーネントに対して行われます。各サブコマンドでは、コンポーネントを表示しないと、ユーティリティの操作はすべてのコンポーネントに対して行われます。

このユーティリティで使用可能なコンポーネントの説明、および各コンポーネントについてttTraceMonが返す情報については、『Oracle TimesTen In-Memory Databaseトラブルシューティング・プロシージャ・ガイド』のttTraceMonユーティリティの使用に関する説明を参照してください。

必要な権限

このユーティリティには、ADMIN権限が必要です。

構文

ttTraceMon {-h | -help | -?}
ttTraceMon {-V | -version}
ttTraceMon [-e subcommand] {-connStr connection_string | DSN}

オプション

ttTraceMonユーティリティには、次のオプションがあります。

オプション

説明

-connStr connection_string

データベース名、サーバー名とDSN(必要に応じて)および関連する接続属性を含むODBC接続文字列。

DSN

トレース情報の取得元となるデータベースのODBCデータソース名を示します。

-e subcommand

指定したデータベースに対してサブコマンドが実行されます。サブコマンドが2語以上で構成される場合は二重引用符で囲みます。次に例を示します。

ttTraceMon -e "show err" SalesData

サブコマンドが完了すると、ttTraceMonは終了します。-eを指定しない場合は、ttTraceMonは対話モードで起動し、stdinからコマンドを読み込んで、stdoutに結果を表示します。

-h
-help

-?

使用方法のメッセージを出力して終了します。

-V | -version

ttTraceMonのリリース番号を出力し、終了します。

サブコマンド

ttTraceMonは、次のサブコマンドを使用してコールできます。

コマンド

説明

components

すべてのcomponentsの名前および内部識別子を表示します。
このユーティリティで使用可能なコンポーネントの説明、および各コンポーネントについてttTraceMonが返す情報については、『Oracle TimesTen In-Memory Databaseトラブルシューティング・プロシージャ・ガイド』のttTraceMonユーティリティの使用に関する説明を参照してください。

connection {all | self | connectionNum} [on |off]

指定した接続のトレース機能を有効または無効にします。データベースの作成時には、トレース機能はすべての接続に対して有効になっています。connectionNumの値は、接続スロット番号またはトランザクションIDの最初の数字を意味しています。

dump

現在バッファされているトレース・レコードをすべて出力します。SELECT権限またはデータベース・オブジェクトの所有権が必要です。

dump comp

コンポーネントcompのトレース・レコードをすべて出力します。SELECT権限またはデータベース・オブジェクトの所有権が必要です。

flush

バッファ済のトレース・レコードをすべて破棄します。

flush comp

コンポーネントcompのバッファ済のトレース・レコードをすべて破棄します。

help

トレース・コマンドのサマリーを出力します。

level comp n

コンポーネントcompのトレース・レベルをnに設定します。ADMIN権限またはデータベース・オブジェクトの所有権が必要です。

outfile file

トレース出力を指定のファイルに出力します。fileに設定できる値は、0、stdout、stderrまたはファイル名です。Windowsでは、ファイル名は8.3形式の短い名前である必要があります。fileに0を設定した場合、出力は停止します。TimesTenは通常どおりトレースのバッファを継続し、これらはttTailのようなユーティリティでアクセス可能です。fileを指定しない場合は、現在のoutfile設定が出力されます。

show

有効なトレース・レベルをすべて表示します。

show comp

コンポーネントcompのトレース・レベルを表示します。

注意

トレース機能によってパフォーマンスが大幅に低下する可能性があるため、問題のデバッグに対してのみトレース機能を有効にしてください。この情報は、主にTimesTenカスタマ・サポートによる使用を目的としていますが、システム管理者およびシステム開発者に役立つ場合もあります。

このユーティリティは、TimesTen Data Managerがインストールされている場合にのみサポートされます。

ttUser

説明

パスワードの入力を要求し、暗号化されたパスワードを返します。その後、この出力を接続文字列に含めるか、またはODBCINIファイルのPWDCrypt接続属性に対する値として含むことができます。

必要な権限

このプロシージャには、権限は必要ありません。

構文

ttUser {-h | -help | -?}
ttUser {-V | -version}
ttUser -pwdcrypt

オプション

ttuserユーティリティは、次のオプションをサポートします。

オプション

説明

-h
-help

-?

使用方法のメッセージを出力して終了します。

-pwdcrypt

PWDCrypt接続属性に対する暗号化されたパスワード値を生成します。

-V | -version

ttuserのリリース番号を出力し、終了します。

ttVersion

説明

ttVersionユーティリティは、リリース番号、プラットフォーム、インスタンス名、インスタンス管理者、インスタンス・ホーム・ディレクトリ、デーモン・ホーム・ディレクトリ、ポート番号およびビルド・タイムスタンプなどの、TimesTenリリース情報を表示します。次のように様々な出力レベルを指定できます。

- 出力を簡略形式で表示するには、オプションなしでttVersionを指定します。

- 出力を拡張形式で表示するには、-mオプションを指定します。

- 特定の属性の出力のみを表示するには、属性を指定します。

必要な権限

このプロシージャには、権限は必要ありません。

構文

ttVersion [-m] [attribute] [...]

オプション

ttVersionには次のオプションがあります。

オプション

説明

-m

コンピュータで読取り可能な、詳細な出力を生成します。指定しない場合や属性を省略した場合は、簡略形式で情報が表示されます。

attribute

指定した属性に関する情報のみを生成します。複数の属性を指定できます。複数の属性を指定すると、その出力は属性名の後に等号が付いて表示されます。

属性

ttVersionには次の属性があります。

属性

説明

patched

このリリースにパッチが適用されているかどうかについて、yesまたはnoで示します。

product

製品名を表示します。

major1

5桁のリリース番号の最初の数字。

major2

5桁のリリース番号の2番目の数字。

major3

5桁のリリース番号の3番目の数字。

patch

5桁のリリース番号の4番目の数字。

portpatch

5桁のリリース番号の5番目の数字。

version

5桁のリリース番号のすべての番号をピリオドで区切った数字。

shortversion

5桁のリリース番号のうち、最初の3桁の数字。

numversion

5桁のリリース番号のうち、最初の4桁の番号をそれぞれ3桁で表した数字。

bits

このリリースでサポートされるオペレーティング・システムのビット・レベル(32または64)を表示します。

os

このリリースでサポートされるオペレーティング・システム

buildstamp

特定のビルドを表す番号。

buildtime

ここリリースがビルドされたUTC時間(例: 2013-03-19T17:21:59Z)

clientonly

このリリースがクライアント専用かどうかを表示します(yesまたはno)。

instance

インスタンス名(例: tt1122_32)。

effective_port

メイン・デーモンがリスニングしているポート番号。

orig_port

メイン・デーモンがリスニングしていた元のポート番号。

instance_admin

インスタンス管理者のユーザー名。

effective_insthome

インスタンスの場所を示すパス。

effective_insthome_long

Windowsでは、インスタンス名でのビット拡張を含むインスタンスの場所を示すパスです。

orig_insthome

インスタンスの場所を示すパス。

effective_daemonhome

特定のインスタンスが使用するデーモン・ホーム・ディレクトリのパス。

effective_daemonhome_long

Windowsでは、インスタンス名でのビット拡張を含む、特定のインスタンス用のデーモンのホームへのパスです。

orig_daemonhome

元のデーモン・ホーム・ディレクトリのパス。

plsql

このインスタンス用にPL/SQLが構成されているかどうかを示します。0はPL/SQLが構成されていないことを示します。1はPL/SQLが構成されていることを示します。この値はPLSQL接続属性の設定に対応しています。

group_name

インスタンス・グループの名前。

出力

ttVersionは次のサンプルのような出力を生成します。

TimesTen Release 11.2.2 (32 bit Linux/x86) (tt1122_32:53384)
2013-03-26T23:00:04Z
Instance admin: terry
Instance home directory: spider/terry/TimesTen/tt1122_32
Daemon home directory: spider/terry/TimesTen/tt1122_32/srv/info

ttVersion -mで、次のサンプルのような出力が生成されます。ほとんどのエントリは、パッチ・リリースの場合にのみ出力されます。

patched=yes
product=TimesTen
major1=11
major2=2
major3=2
patch=5
portpatch=0
version=11.2.2.5.0
shortversion=1122
numversion=110200020500
bits=32
os=Linux
buildtstamp=1364278134
buildtime=2013-03-26T06:08:54Z
clientonly=no
instance=tt1122_32
effective_port=53392
orig_port=53392
instance_admin=terry
effective_insthome=/spider/terry/ttcur/TTBuild/linux86_dbg/tt1121_32
orig_insthome=/spider/terry/ttcur/TTBuild/linux86_dbg/tt1121_32
effective_daemonhome=/spider/terry/ttcur/TTBuild/linux86_dbg/tt1121_32/info
orig_daemonhome=/spider/terry/ttcur/TTBuild/linux86_dbg/tt1121_32/info
plsql=0
groupname=timesten

ttXactAdmin

説明

ttXactAdminユーティリティは、未処理の各トランザクションの所有者、ステータス、ログおよびロックの情報を表示します。また、ttXactAdminユーティリティを使用すると、XAトランザクション・ブランチのコミット、終了または消去を経験則的に実行できます。

アプリケーションではログの保持とログ・ファイルの蓄積を監視する必要があります。詳細は、『Oracle TimesTen In-Memory Databaseオペレーション・ガイド』のトランザクション・ログ・ファイルの蓄積の監視に関する説明を参照してください。

必要な権限

このユーティリティを使用するには、コマンドラインに入力するオプションに応じて様々な権限が必要です。必要な権限を確認するには、オプションの説明を参照してください。

構文

ttXactAdmin {-h | -help | -?}
ttXactAdmin {-V | -version}

ttXactAdmin [-v verbosity] [-mt maxTrans] [-ml maxLocks] [-pid pid]
[-xact xid] [-tbl [owner.]tableName] [-interval seconds]
[-count iterations] {DSN | -connstr connectionString}

ttXactAdmin -latch [-interval seconds] [-count iterations]
{DSN | -connstr connStr}

ttXactAdmin -latchstats clear | off |on | [show] [-interval seconds]
[-count iterations] {DSN | -connstr connectionString}

ttXactAdmin -connections [-pid pid] [-interval seconds]
[-count iterations] {DSN | -connstr connStr}

ttXactAdmin -xactIdRollback xid {DSN | -connstr connStr}

ttXactAdmin {-HCommit xid | -HAbort xid | -HForget xid} {DSN | -connstr connStr}

オプション

ttXactAdminには次のオプションがあります。

オプション

説明

-connections

データベースへの現在の接続をすべて表示します。-connectionsオプションとともに実行する場合、ttXactAdmin自体はデータベースへ実際の接続を確立せず、ラッチを要求しません。このことは、フリーズしたシステムを診断するときに役立つことがあります。
このオプションには、ADMIN権限が必要です。

-connStr connectionString

データベース名、サーバー名とDSN(必要に応じて)および関連する接続属性を含むODBC接続文字列。

-count iterations

iterations回レポートを生成します。-intervalオプションを指定しない場合は、1秒間隔で生成します。

DSN

管理するデータベースのODBCデータソース名を示します。
このオプションには、ADMIN権限が必要です。

-h
-help

-?

使用方法のメッセージを出力して終了します。

-HAbort xid

TimesTenのXAトランザクション・ブランチを経験則的に終了します。トランザクションIDには、ローカルTimesTenのTransIDを指定する必要があります。
このオプションには、ADMIN権限または指定したトランザクションの所有権が必要です。

-HCommit xid

TimesTenのXAトランザクション・ブランチを経験則的にコミットします。トランザクションIDには、ローカルTimesTenのTransIDを指定する必要があります。
このオプションには、ADMIN権限または指定したトランザクションの所有権が必要です。

-HForget xid

TimesTenのXAトランザクション・ブランチを経験則的に消去します。トランザクションIDには、ローカルTimesTenのTransIDを指定する必要があります。
このオプションには、ADMIN権限または指定したトランザクションの所有権が必要です。

-interval seconds

指定した秒数一時停止しながら、レポートの生成を繰り返します。-countオプションが指定されない場合は、永続的に繰り返します。

-latch

このオプションは、TimesTenカスタマ・サポートによってのみ使用されます。このオプションは、指定したデータベースのラッチ情報のみを表示します。

-latchstats[clear | off | on | show]

このオプションは、TimesTenカスタマ・サポートによってのみ使用されます。このオプションは、リクエストしたlatchstat処理を実行します。
このオプションには、ADMIN権限が必要です。

-latchstatsを使用すると、それ以外のオプションは無視されます。

clear: すべてのlatchstat情報を0(ゼロ)にリセットします。

off: latchstatの収集をオフにします。

on: latchstatの収集をオンにします。

show(デフォルト): アクセス・カウントやその他のstatsを含むラッチ情報を表示します。

-ml maxLocks

トランザクションごとのロックの最大数です。デフォルトは6000です。

-mt maxTrans

表示する最大トランザクション数を指定します。デフォルトは、未処理のトランザクションすべてが表示されます。

-pid pid

指定したpidのプロセスによって開始されたトランザクションのみを表示します。Linuxでは、接続をオープンしたスレッドのpidです。
このオプションには、ADMIN権限または指定したトランザクションの所有権が必要です。

-row rowid

指定した行のロック情報を表示します。
このオプションには、ADMIN権限またはデータベース・オブジェクトの所有権が必要です。

-tbl [owner.]tableName

指定した表のロック情報を表示します。
このオプションには、ADMIN権限または指定した表の所有権が必要です。

-V | -version

ttXactAdminのリリース番号を出力し、終了します。

-v verbosity

冗長レベルを指定します。次のいずれかです。
0: 行ロックの表の名前を表示しません。この場合、ttXactAdminの実行がより高速になります。

1(デフォルト): 行ロックの表の名前を表示します。

-xact xid

ログの保持LSNを含む、指定したトランザクションの情報を表示します。出力では、フィールド「Last ID」は2つの順序番号のセットです。時間隔内に順序番号が変わらなかった場合、その時間隔内にトランザクションによって書き込まれたログ・レコードはありません。
このオプションには、ADMIN権限または指定したトランザクションの所有権が必要です。

-xactIdRollback xid

トランザクションをロールバックできるようにします。これは長時間実行されるトランザクションで特に役立つ場合があります。パラメータxidはトランザクションIDを表します。現在実行している処理をトランザクションにかわって停止してから、TimesTen内でトランザクションをロールバックします。
ロールバックがリクエストされたときにチェックポイント処理が進行中の場合、TimesTenによってチェックポイント処理が終了されます。このコマンドによって、Oracle Database上でのTimesTen Cache操作が停止されることはありません。操作には、PassThrough文、フラッシング、手動ロード、手動リフレッシュ、同期ライトスルー、伝播および動的ロードが含まれます。

このオプションには、ADMIN権限または指定したトランザクションの所有権が必要です。

出力

ttXactAdminは次の出力を生成します。

列

説明

Program File Name

トランザクションを所有するプロセスの実行可能ファイル名です。

PID

トランザクションを所有するアプリケーションのプロセスIDです。Linuxでは、これは接続をオープンしたスレッドのPIDです。

Context

単一のマルチスレッド・プロセスによる、データベースへの複数の接続で区別するための内部識別子です。

TransId

TimesTenによって内部的に使用される、一意のトランザクション識別子です。識別子は2つの部分で構成されます。
最初の部分は比較的小さな値(2048未満)で、トランザクションを実行するプログラムの接続を識別するために使用されます。

2つ目の部分は大きな値(符号なし整数)になる可能性が高く、最初の部分が続けて使用される場合にそれらを区別します。(この値は必要に応じて始めに戻ります。)このため、識別子4.100および4.200は同時には存在しません。4.100が出現し、その次に4.200が出現する場合、これはトランザクション4.100が完了(コミットまたはロールバック)したことを示しています。

TransStatus

トランザクションの現在のステータスです。次のいずれかです。
Active - アクティブなトランザクション。

Aborting: 終了処理中のトランザクション。詳細は、「注意」を参照してください。

Committing: コミット中のトランザクション。ロックが解放されています。

Ckpointing: チェックポイントを実行しているトランザクション。

Rep-Wait-Return: RETURN RECEIPT/コミットを待機している、レプリケートされたトランザクション。

Idle: データに現在アクセスしていないトランザクション・ブランチ。

Prepared: 準備されたトランザクション・ブランチ。

Heur-Committed: 経験則的にコミットされたトランザクション・ブランチ。

Heur-Aborted: 経験則的に終了されたトランザクション・ブランチ。

Propagating: Oracleのコミットを待機しているTimesTenトランザクション。

Resource

要求されているロックのタイプです。
Row - 行レベル・ロック。

HashedKey: ハッシュ索引のキー値に保持されたロック。処理でハッシュ索引を更新する必要がある場合に取得されます。

Table - 表レベル・ロック。

EndScan: 表または範囲スキャン・ロックの終了。

Database - データベース・レベル・ロック。

Command - コマンド・ロック。

Prepare: コマンドの準備中に取得されたロック。

GrpComm: グループ・コミット・ロック。

ReplHold: レプリケーション保持のロック。

XlaHold: XLA保持のロック。

ResourceId

一意の各リソースの一意識別子。この識別子は、いくつかの例外を除いて、16進形式で表示されます。TableおよびCompCmdは、10進値で表示されます。行ロックは、ROWID文字形式で表示されます。

Mode

ロックが提供する同時実行性のレベルを判断するために使用される値です。
S: シリアライズ可能な分離における共有ロック。

Sn: シリアライズ可能でない分離における共有ロック。

U: シリアライズ可能な分離における更新ロック。

Un: シリアライズ可能でない分離における更新ロック。

En: シリアライズ可能でない分離におけるスキャン終了ロック。

IRC: シリアライズ可能でない分離における意図的な共有ロック。

IS: シリアライズ可能な分離における意図的な共有ロック。

IU: シリアライズ可能な分離における意図的な更新ロック。

IUn: シリアライズ可能でない分離における意図的な更新ロック。

IX: シリアライズ可能な分離における意図的な排他ロック。

IXn: シリアライズ可能でない分離における意図的な排他ロック。

SIX: シリアライズ可能な分離における、排他ロックの設定を目的とした共有ロック。

SIXn: シリアライズ可能でない分離における、排他ロックの設定を目的とした共有ロック。

X - 排他ロック。

Xn: シリアライズ可能でない分離における排他ロック。

W: 更新、挿入または削除表ロック。

XNi: 表または一意でない索引に挿入するための次のロック。

NS: シリアライズ可能な分離におけるすべての表ロックと競合するコミット読取り分離における表ロック。ロック0は、ブロックしている処理がまだ待機リストにあることを意味します。

HMode

待機状態のトランザクションが要求しているロックを保持する競合トランザクションのロック・モード。
同時実行性レベルについては、この表の「Mode」を参照してください。

RMode

待機状態のトランザクションがロックの保持を要求しているモードを示します。同時実行性レベルについては、この表の「Mode」を参照してください。

HolderTransId

待機状態のトランザクションが競合しているトランザクションの識別子。

Name

ロックが保持されている、またはロックを含む表の名前。

例

次のコマンドはデータベース内のすべてのロックを表示します。

ttXactAdmin -connstr DSN=demodata

Outstanding locks

PID   Context  TransId     TransStatus Resource  ResourceId         Mode Name
Program File Name: localtest
10546 0x118e28 2047.000003 Active      Table     411104             IS  SYS.TABLES
Table     416480             IXn TEST1.TAB1
Row       BMUFVUAAABQAAAAGTD Sn  SYS.TABLES
Hashed Key 0x69cf9c36        Sn  SYS.TABLES
Database   0x01312d00        IX
Row       BMUFVUAAABQAAAAGzD Xn  TEST1.TAB1
Program File Name: /users/smith/demo/XAtest1
XA-XID: 0xbea1-001b238716dc35a7425-64280531947e1657380c5b8d
1817 0x118e28 2046.000004 Active       Table    416480              IS  TEST1.TAB1
CompCmd  21662408            S
Database 20000000            IS
Row      BMUFVUAAABQAAAAJzD  Sn  TEST1.TAB1
Program File Name: /users/smith/demo/XAtest2
XA-XID: 0xbea1-001c99476cf9b21e85e1-70657473746f7265506f6f6c
27317 0x118e28 2045.000005 Prepared    Table  411104             IS   SYS.TABLES
Table  416816             IXn  TEST1.TAB2
Row    BMUFVUAAABQAAAAMzD Sn   SYS.TABLES
Database   0x01312d00     IX
Hashed Key 0x67fe3852     Sn   SYS.TABLES
Row    BMUFVUAAABQAAAAHTE Xn   TEST1.TAB2
Program File Name: /users/smith/demo/Reptest
27589 0x118e28 2044.000006 Rep-Wait-Return
Awaiting locks
PID  Context  TransId     Resource ResourceId RMode HolderTransId HMode Name
Program File Name: /users/smith/demo/XAtest1
1817 0x118e28 2046.000004 Row BMUFVUAAABQAAAAPTD  Sn  2047.000003   Xn  TEST1.TAB1

次のコマンドはトランザクション2045.000005に対するすべてのロックを表示します。

ttXactAdmin -xact 2045.000005 -connstr DSN=demodata
PID   Context  TransStatus 1stLSN    LastLSN  Resource ResourceId Mode Name
Program File Name: /users/smith/demo/XAtest2
XA-XID: 0xbea1-001c99476cf9b21e85e1-70657473746f7265506f6f6c
27317 0x118e28 Prepared    0.0116404 0.0116452 Table 411104         IS  SYS.TABLES
Table   416816         IXn TEST1.TAB2
Row BMUFVUAAABQAAAAGzE Sn  SYS.TABLES
Database 0x01312d00    IXn
Hashed Key 0x67fe3852  Sn SYS.TABLES
Row BMUFVUAAABQAAAAKzE Xn TEST1.TAB2

データベースへのすべての接続を表示するには、次のコマンドを実行します。

$ ttXactAdmin -connections sample
2006-09-10 10:26:33
/datastore/terry/sample
TimesTen Release 11.2.2.0.0

ID   PID    Context            Name           Program        State TransID UID
1    29508  0x00000001001c6680 myconnection   ttIsql         Run   1.23    TERRY
2044 29505  0x0000000100165290 Worker         timestensubd   Run           TERRY
2045 29505  0x00000001001df190 Flusher        timestensubd   Run           TERRY
2046 29505  0x000000010021cc50 Monitor        timestensubd   Run           TERRY
2047 29505  0x0000000100206730 Checkpoint     timestensubd   Run           TERRY
5 connections found

注意

コマンドで指定されたトランザクションがXAトランザクション・ブランチでなく、TimesTenのローカル・トランザクションである場合、XA-XIDは表示されません。XA-XIDはフォーマット識別子を含むC構造体で、2つのデータ長フィールドと1つのデータ・フィールドを持ちます。データ・フィールドは、グローバル・トランザクション識別子(gtrid)およびブランチ修飾子(bqual)という、最大2つの連続するコンポーネントで構成されます。2つのデータ長フィールドは、gtridおよびbqualのバイト数(1-64)をそれぞれ指定します。詳細は、X/Openの文書『Distributed Transaction Processing』のXA仕様(c193)に関する説明を参照してください。

データベースでは、シリアライズ可能な分離モードの場合に、TimesTenはSロックのみを保持します。コマンドでは、Sは「共有」ロックのみを意味し、シリアライズ可能な分離モードでもコミット読取り分離モードでも保持できます。RModeを指定すると、待機中のトランザクションはPIDおよびコンテキストによってソートされます。リストにはロック・リクエストの順番は反映されません。

ロック・リクエスト・キュー内で、互換性のあるモードのリクエストの前に互換性のないモードの別のロック・リクエストがあるため、HModeのロック保持者と互換性のあるRModeのロック・リクエストが待機することがあります。

次のいずれかの理由により、トランザクションはAbortingステータスになります。

- 大量の処理を行った後にユーザー・アプリケーションによってロールバックが要求された。

- autocommitが有効なアプリケーションで、完了できなかった文を実行しようとして、実行できないままでいる。

- ttXactAdminへの別のコールによってトランザクションのロールバックが発生した。

- 処理中のプロセスが停止し、その処理が完了していない。

ttXactLog

説明

TimesTenトランザクション・ログのコンテンツの形式が整えられたダンプを表示します。これは、ログまたはデータベース内の問題を診断するために、TimesTenカスタマ・サポートによって使用されるように設計されています。

-trなどの特定のオプションの使用によりデータを失う可能性があるため、このツールはTimesTenカスタマ・サポートの担当者に指示された場合にのみ使用してください。

必要な権限

このユーティリティには、ADMIN権限が必要です。

構文

ttXactLog {-h | -help | -?}

ttXactLog {-V | -version}

ttXactLog [-v verbosity] [-m maxChars] [-s] [-t] [-b blkID]
[-l1 lfn.lfo [-l2 lfn.lfo]] [-r recType] [...] [-tr dir]
[-lb] [-headers recs] [-logdir dir]
{-connStr connection_string | DSN | dspath}

ttXactLog [-v verbosity] -logAnalyze
[-s subscriberName -host hostname]]
[-xid xid] {-connStr connection_string | DSN | dspath}

オプション

ttXactLogには次のオプションがあります。

オプション

説明

-b blkID

ログ・レコードを、このブロックにアクセスするものとトランザクション・レコードに制限します。

-connStr connectionString

データベース名、サーバー名とDSN(必要に応じて)および関連する接続属性を含むODBC接続文字列。

DSN

表示するトランザクション・ログに対するデータベースのODBCソース名。

dspath

データベースの完全修飾名。これは接続に関連付けられたDSNではなく、データベースのODBC定義でDataStore=パラメータに指定した、データベースに関連付けられた完全修飾データベース・パス名です。
たとえば、ファイル/home/payroll/2011.ds0, /home/payroll/2011.ds1およびいくつかのトランザクション・ログ・ファイル/home/payroll/2011.lognからなるデータベースの場合、dspathは/home/payroll/2011です。

-h
-help

-?

使用方法のメッセージを出力して終了します。

-headers records

recordsごとのレコードに対して1つのヘッダーを出力します。0 (ゼロ)を指定すると、ヘッダーは無効になります。

-host hostName

サブスクライバが常駐するホストの名前を指定します。サブスクライバの名前が曖昧な場合には、このオプションを-subscriberオプションとともに使用してください。

-lb

データベースに接続して、ログ・バッファを出力します。トランザクション・ログ・ファイルのコンテンツは出力されません。SELECT権限またはデータベース・オブジェクトの所有権が必要です。

lfn.lfo

ログ・レコードのトランザクション・ログ・ファイル番号(lfn)およびトランザクション・ログ・ファイル・オフセット(lfo)。

-l1

引数-l2が存在しないかぎり、このログ・レコードのみを考慮します。

-l2

-l1から-l2のレコードを考慮します。

-logAnalyze

1つまたはすべてのサブスクライバに対してレプリケートされるデータベースの残りの分量を決定します。出力するには、-vオプションとともに使用します。
1: 各トラック用のサマリー(デフォルト)。

2: レベル1にトラック分析をプラス。3: レベル2に詳細なトランザクション分析をプラス。特定のサブスクライバについての情報を取得するには、-subscriberおよび-hostとともに使用します。

特定のトランザクションIDを検索するには、-xidとともに使用します。

-logdir dir

データベースのトランザクション・ログ・ファイルが存在するディレクトリを指定します。-logdirを指定しない場合は、ttXactLogはdspathに指定されている値のディレクトリ・パス部分を使用します。

-m maxChars

-v 3のbinary項目のみについて出力される最大文字数。デフォルトは4000です。

-r recType

指定したタイプのレコードのみを考慮します。このオプションは必要なログ・レコード・タイプのリストを指定するために、複数回使用される場合があります。recTypeでは大/小文字が区別されます。

-s

サマリー情報を出力します。SELECT権限またはデータベース・オブジェクトの所有権が必要です。

-subscriber subscriberName

サブスクライバの名前を指定します。サブスクライバ名を修飾するには、-host hostnameを使用します。

-t

トランザクション・ログ・ファイルの下部(最後のチェックポイント・トランザクション・ログ・ファイル、またはチェックポイントがない場合は最新のトランザクション・ログ・ファイルの始まりから)のみ読み取ります。

-tr dir

ディレクトリにあるすべてのログ・レコードをLWN境界で切り捨てます。元のトランザクション・ログ・ファイルはディレクトリdirに移動されます。

-V | -version

ttXactLogのリリース番号を出力し、終了します。

-v verbosity

冗長レベルを指定します。次のいずれかです。
0: サマリー・ログ情報のみを出力します(-sが指定されている場合)。

1(デフォルト): ログ・レコード・ヘッダーも出力します。

2: 長いデータを除いて、ログ・レコード本体も出力します。

3: ログ・レコード全体を出力します(-mオプションを参照)。

-x xid

トランザクションIDを指定します。

例

ttXactLog -v 3 -m 100 /users/pat/TimesTen/Daily/F112697SS

注意

このユーティリティは、TimesTen Data Managerがインストールされている場合にのみサポートされます。

関連項目

『Oracle TimesTen In-Memory Database開発者および管理者ガイド』のレプリケーション・ログの未処理のトランザクションの分析に関する説明を参照してください。

4 システム制限

次の項では、TimesTenのすべてのシステム制限とデフォルトについて説明します。

- システム制限およびデフォルト

- オープン・ファイル数の制限

- パス名

システム制限およびデフォルト

特定のオペレーティング・システムの制限は、これらの値よりも優先されます。詳細は、『Oracle TimesTen In-Memory Databaseインストレーション・ガイド』のインストールの前提条件に関する説明を参照してください。

説明

32ビットの値

64ビットの値

アクティブ・スタンバイ・ペアではないレプリケーション・スキーム内のサブスクライバ・データベースの最大数。

128

128

レプリケーション・スキーム内のプロパゲータの最大数。各プロパゲータにはサブスクライバ数に上限があります。

128

128

アクティブ・スタンバイ・ペアのサブスクライバ・データベースの最大数。

127

127

データベースの最小サイズ(バイト)。このサイズには、データベースで操作を行うために必要な永続領域と一時領域の両方のサイズが含まれます。

32MB

32MB

固定長列の最大長(バイト)。

8,300

8,300

表内の列の最大数。

1,000

1,000

ORDER BY句内の列の最大数。

1,000

1,000

GROUP BY句内の列の最大数。

1,000

1,000

行の固定長列の最大累積長(バイト)。

32,768

32,768

可変長列の最大長(バイト)。

2^22 = 4,194,304

2^22 = 4,194,304

レプリケートされる列の最大長。

4MB
BLOB型の列の場合は16MB

4MB
BLOB型の列の場合は16MB

データベースへの最大同時接続数(システム接続を含む)。

2047

2047

データベースへのアプリケーションの最大同時接続数(セマフォ構成またはConnections DSN属性、あるいはその両方によって制限される可能性がある)。

2000

2000

インスタンス内のすべてのデータベースでの最大接続数(システムおよびアプリケーション)。

2048

2048

TimesTenインスタンスへのクライアントの最大同時接続数。
注意: データベースが共有またはレプリケートされている状況や、オペレーティング・システムの制限などによって、インスタンスがサポートする最大接続数は異なります。一般的な構成では、2,000以上の接続がサポートされます。

2048

2048

データベース名の最大長。

32

32

非同期のWRITETHROUGHキャッシュ・グループにおけるデータベースのパス名の最大長

248

248

SELECT文内の投影式の最大数。

32,767

32,767

結合順序を指定する文字列の最大長。

1,024

1,024

索引(主キー)内の列の最大数。

16

16

基本名の最大長。

30

30

SYS.PLAN表内に表示される述語文字列の最大長。

1,024

1,024

NULL終端文字を含むSQL文の最大長。

409,600

409,600

SQL問合せでの表参照の最大数。

24

24

表の索引の最大数。

500

500

表内のパーティションの最大数。

999

999

接続当たりの準備されたPL/SQL文の最大数。

5000

5000

セッションごとにキャッシュ可能な最近使用したPL/SQLブロックの最大数。

5000

5000

TimesTenインスタンスごとの共有メモリー・セグメントにおけるクライアント/サーバーの最大同時接続数。

512

512

クライアント/サーバー接続に割り当てられているIPC共有メモリー・セグメントの最大サイズ。

1GB

1GB

共有メモリー・セグメントのクライアント/サーバー接続ごとに割り当てられている文ハンドルの最大数。

512

512

ネストされた副問合せの最大深度。

SQL問合せにおける表参照の最大数と同じ。

SQL問合せにおける表参照の最大数と同じ。

エラー・メッセージの長さを指定するアプリケーションのエラー・メッセージの最大長(SQLErrorへのコールなど)。

512

512

オープン・ファイル数の制限

TimesTenデータベースに接続される各プロセスは、初期接続時からプロセス終了時まで、少なくとも1つのオペレーティングシステム・ファイル記述子をオープンのまま保持します。データベースへの各接続では、次のように追加のファイル記述子がオープンされることもあります。

- ディスクへのロギングを有効にするデータベースへの接続では、接続中に追加のファイル記述子が2つ必要です。

- プロセスが発行するデータベースのチェックポイントの実行中に、追加のファイル記述子が1つ必要です。

- トランザクションのコミットまたはロールバックの操作中に、追加のファイル記述子がオープンされることもあります。

TimesTenデータベースへの多数の同時接続を保持するマルチスレッド・アプリケーションでは、オペレーティング・システムが各プロセスに許可しているデフォルトのオープン・ファイル数が少なすぎる場合があります。

- Solarisの場合、デフォルトの制限は256オープン・ファイルですが、セッション中にulimitコマンド(cshユーザーの場合はlimit)を使用して増やすこともできます。また、setrlimitによってプロセス当たりの制限をプログラムで設定することもできます。

- AIXの場合、制限は2,048オープン・ファイルであるため、これが問題になることはほとんどありません。

- Linuxの場合、デフォルトの制限は1,024オープン・ファイルであるため、これが問題になることはほとんどありません。

- Windowsの場合、デフォルトの制限は2,000オープン・ファイル以上であるため、これが問題になることはほとんどありません。

ほとんどのオープン・ファイル記述子は、データベース・リカバリ・ログ・ファイルの読み書きに使用されます。プロセスでログ・ファイルのオープンに失敗した場合、データベースはリカバリを必要とするものとして指定され、データベースへの現在の接続はすべて終了されます。

パス名

TimesTenでは、マルチバイト文字を含むファイル・パス名はサポートされていません。インストール・パス、データベース・パス、トランザクション・ログ・パスおよび一時ファイル・パスにマルチバイト・キャラクタが含まれていないことを確認してください。

索引
A B C D E F G H I J L M N O P Q R S T U V W X

A

アクセス制御

接続属性, 1.1

utilities, 1.2, 3.2.1

管理

デーモン, ttDaemonAdminユーティリティ, 3.2.2

データベース, ttAdminユーティリティ, 3.2.2

AllFlagsオプティマイザ・フラグ, 2 属性, 「接続属性」を参照 認証, ユーティリティ, 1.2 AutoCreate接続属性, 1.2

B

バックアップ

ttBackupユーティリティ, 3.2.2

ttBackupStatus組込みプロシージャ, 2

BranchAndBoundオプティマイザ・フラグ, 2 組込みプロシージャ

コール, 2

ttAgingLRUConfig, 2

ttAgingScheduleNow, 2

ttApplicationContext, 2

ttBackupStatus, 2

ttBlockInfo, 2

ttBookmark, 2

ttCacheAllowFlushAwtSet, 2

ttCacheAutorefIntervalStatsGet, 2

ttCacheAutorefresh, 2

ttCacheAutorefreshLogDefrag, 2

ttCacheAutorefreshSelectLimit, 2

ttCacheAutorefreshStatsGet, 2

ttCacheAutorefreshXactLimit, 2

ttCacheAWTMonitorConfig, 2

ttCacheAWTThresholdGet, 2

ttCacheAWTThresholdSet, 2

ttCacheCheck, 2

ttCacheConfig, 2

ttCacheDbCgStatus, 2

ttCachePolicyGet, 2

ttCachePolicySet, 2

ttCachePropagateFlagSet, 2

ttCacheSqlGet, 2

ttCacheStart, 2

ttCacheStop, 2

ttCacheUidGet, 2

ttCacheUidPwdSet, 2

ttCkpt, 2

ttCkptBlocking, 2

ttCkptConfig, 2

ttCkptHistory, 2

ttCommitBufferStats, 2

ttCommitBufferStatsReset, 2

ttCompact, 2

ttCompactTS, 2

ttComputeTabSizes, 2

ttConfiguration, 2

ttContext, 2

ttDataStoreStatus, 2

ttDBConfig, 2

ttDbWriteConcurrencyModeGet, 2

ttDbWriteConcurrencyModeSet, 2

ttDurableCommit, 2

ttGridAttach, 2

ttGridCheckOwner, 2

ttGridCreate, 2

ttGridDestroy, 2

ttGridDetach, 2

ttGridDetachAll, 2

ttGridDetachList, 2

ttGridFirstMemberAttach, 2

ttGridGlobalCGResume, 2

ttGridGlobalCGSuspend, 2

ttGridInfo, 2

ttGridNameSet, 2

ttGridNodeStatus, 2

ttHostNameGet, 2

ttHostNameSet, 2

ttIndexAdviceCaptureDrop, 2

ttIndexAdviceCaptureEnd, 2

ttIndexAdviceCaptureInfoGet, 2

ttIndexAdviceCaptureOutput, 2

ttIndexAdviceCaptureStart, 2

ttLoadFromOracle, 2

ttLockLevel, 2

ttLockWait, 2

ttLogHolds, 2

ttMonitorHighWaterReset, 2

ttOptClearStats, 2

ttOptCmdCacheInvalidate, 2

ttOptEstimateStats, 2

ttOptGetColStats, 2

ttOptGetFlag, 2

ttOptGetMaxCmdFreeListCnt, 2

ttOptGetOrder, 2

ttOptSetColIntvlStats, 2

ttOptSetColStats, 2

ttOptSetFlag, 2

ttOptSetMaxCmdFreeListCnt, 2

ttOptSetMaxPriCmdFreeListCnt, 2

ttOptSetOrder, 2

ttOptSetTblStats, 2

ttOptShowJoinOrder, 2

ttOptStatsExport, 2

ttOptUpdateStats, 2

ttOptUseIndex, 2

ttPLSQLMemoryStats, 2

ttRamPolicyAutoReloadGet, 2

ttRamPolicyAutoReloadSet, 2

ttRamPolicyGet, 2

ttRamPolicySet, 2

ttRedundantIndexCheck, 2

ttRepDeactivate, 2

ttReplicationStatus, 2

ttRepPolicyGet, 2

ttRepPolicySet, 2

ttRepQueryThresholdGet, 2

ttRepQueryThresholdSet, 2

ttRepStart, 2

ttRepStateGet, 2

ttRepStateSave, 2

ttRepStateSet, 2

ttRepStop, 2

ttRepSubscriberStateSet, 2

ttRepSubscriberWait, 2

ttRepSyncGet, 2

ttRepSyncSet, 2

ttRepSyncSubscriberStatus, 2

ttRepTransmitGet, 2

ttRepTransmitSet, 2

ttRepXactStatus, 2

ttRepXactTokenGet, 2

ttSetUserColumnID, 2

ttSetUserTableID, 2

ttSize, 2

ttSQLCmdCacheInfo, 2

ttSQLCmdCacheInfo2, 2

ttSQLCmdCacheInfoGet, 2

ttSQLCmdQueryPlan, 2

ttSQLExecutionTimeHistogram, 2

ttStatsConfig, 2

ttTableSchemaFromOraQueryGet, 2

ttVersion, 2

ttWarnOnLowMemory, 2

ttXactIdGet, 2

ttXlaBookmarkCreate, 2

ttXlaBookmarkDelete, 2

ttXlaSubscribe, 2

ttXlaUnsubscribe, 2

バルク・コピー, ttBulkCpユーティリティ, 3.2.2

C

キャッシュ

DynamicLoadEnable接続属性, 1.2

DynamicLoadErrorMode接続属性, 1.2

OracleNetServiceName接続属性, 1.2

OraclePWD接続属性, 1.2

PassThrough接続属性, 1.2

ポリシー, ttAdminユーティリティ, 3.2.2

RACCallback接続属性, 1.2

ttCacheAdvisorユーティリティ, 3.2.2

キャッシュ・グリッド, 「ttGridXXX組込みプロシージャ」を参照 キャッシュ, 「TimesTen Cache」も参照 CacheAWTMethod接続属性, 1.2 CacheAWTParallelism接続属性, 1.2 CacheGridEnable接続属性, 1.2 CacheGridMsgWait接続属性, 1.2 キャッシュ, 「ttCacheXXX組込みプロシージャ」を参照 キャラクタ・セット

ConnectionCharacterSet接続属性, 1.2

DatabaseCharacterSet接続属性, 1.2

サポートされているキャラクタ・セット, 1.2

チェックポイント

CkptFrequency接続属性, 1.2

CkptLogVolume接続属性, 1.2

CkptRate接続属性, 1.2

ttCkpt組込みプロシージャ, 2

ttCkptBlocking組込みプロシージャ, 2

ttCkptConfig組込みプロシージャ, 2

ttCkptHistory組込みプロシージャ, 2

CkptFrequency接続属性, 1.2 CkptLogVolume接続属性, 1.2 CkptRate接続属性, 1.2 クライアント接続

属性, 1.2, 1.2

TimesTenインスタンスごとの共有メモリー・セグメントにおける同時接続, 最大, 4.1

共有メモリー・セグメントのサイズ, 最大, 4.1

文ハンドル, 共有メモリー・セグメントごとの最大, 4.1

TCP_Port接続属性, 1.2

TCP_Port2接続属性, 1.2

TTC_FailoverPortRange接続属性, 1.2

TTC_Server接続属性, 1.2

TTC_Server_DSN接続属性, 1.2

TTC_Server_DSN2接続属性, 1.2

TTC_Server2接続属性, 1.2

TTC_Timeout接続属性, 1.2

UID接続属性およびPWD接続属性, 1.2

クラスタウェア, ttCWAdminユーティリティ, 3.2.2 COL_STATSシステム表, 2 列ID, XLA, ttSetUserColumnID組込みプロシージャ, 2 列

固定長列, 最大長, 4.1

最大長, 可変長列, 4.1

索引の最大数, 4.1

1つの表当たりの最大数, 4.1

最大, GROUP BY句, 4.1

最大, ORDER BY句, 4.1

レプリケートされる列, 最大長, 4.1

コマンド・キャッシュ, SQL

問合せ計画, ttSQLCmdQueryPlan組込みプロシージャ, 2

ttSQLCmdCacheInfo組込みプロシージャ, 2

ttSQLCmdCacheInfo2組込みプロシージャ, 2

ttSQLCmdCacheInfoGet組込みプロシージャ, 2

ttSQLCmdQueryPlan組込みプロシージャ, 2

コミット

DDLCommitBehavior接続属性, 1.2

DurableCommits接続属性, 1.2

CommitBufferSizeMax接続属性, 1.2 データベースの圧縮

ttCompact組込みプロシージャ, 2

ttCompactTS組込みプロシージャ, 2

同時実行性

アプリケーションの同時接続, 最大, 4.1

クライアントの同時接続, 最大, 4.1

同時接続, 最大, 4.1

同時接続, システムおよびアプリケーション, 最大, 4.1

LockLevel接続属性, 1.2

LockWait接続属性, 1.2

接続

アプリケーションの同時接続, 最大, 4.1

クライアントの同時接続, 最大, 4.1

同時接続, 最大, 4.1

同時接続, システムおよびアプリケーション, 最大, 4.1

競合, 1.2

ConnectionCharacterSet接続属性, 1.2

障害, MatchLogOpts接続属性, 1.2

MaxConnsPerServer接続属性, 1.2

PL/SQL文, 準備済, 最大, 4.1

UID接続属性およびPWD接続属性, 1.2

WaitForConnect接続属性, 1.2

接続属性

アクセス制御, 1.1

AutoCreate, 1.2

CacheAWTMethod, 1.2

CacheAWTParallelism, 1.2

CacheGridEnable, 1.2

CacheGridMsgWait, 1.2

CkptFrequency, 1.2

CkptLogVolume, 1.2

CkptRate, 1.2

クライアント接続属性, 1.2, 1.2

CommitBufferSizeMax, 1.2

ConnectionCharacterSet, 1.2

ConnectionName, 1.2

Connections, 1.2

データソース名, 1.2

データ・ストア属性, 1.2, 1.2

DatabaseCharacterSet, 1.2

DataStore, 1.2

DDLCommitBehavior, 1.2

DDLReplicationAction, 1.2

DDLReplicationLevel, 1.2

Description, 1.2

Diagnostics, 1.2

Driver, 1.2

DuplicateBindMode, 1.2

DurableCommits, 1.2

DynamicLoadEnable, 1.2

DynamicLoadErrorMode, 1.2

初期接続属性, 1.2, 1.2

ForceConnect, 1.2

一般接続属性, 1.2, 1.2

Isolation, 1.2

LockLevel, 1.2

LockWait, 1.2

LogAutoTruncate, 1.2

LogBufMB, 1.2

LogBufParallelism, 1.2

LogDir, 1.2

LogFileSize, 1.2

LogFlushMethod, 1.2

LogPurge, 1.2

MatchLogOpts, 1.2

MaxConnsPerServer, 1.2

MemoryLock, 1.2

NLS一般接続属性, 1.2, 1.2

NLS_LENGTH_SEMANTICS, 1.2

NLS_NCHAR_CONV_EXCP, 1.2

NLS_SORT, 1.2

OracleNetServiceName, 1.2

OraclePWD, 1.2

Overwrite, 1.2

PassThrough, 1.2

PermSize, 1.2

PermWarnThreshold, 1.2

PLSCOPE_SETTINGS, 1.2

PLSQL, 1.2

PL/SQLの初期接続属性, 1.2, 1.2

PL/SQLの一般接続属性, 1.2, 1.2

PLSQL_CCFLAGS, 1.2

PLSQL_MEMORY_ADDRESS, 1.2

PLSQL_MEMORY_SIZE, 1.2

PLSQL_OPTIMIZE_LEVEL, 1.2

PLSQL_TIMEOUT, 1.2

Preallocate, 1.2

PrivateCommands, 1.2

権限, 1.1

PWD, 1.2

PWDCrypt, 1.2

QueryThreshold, 1.2

RACCallback, 1.2

RangeIndexType, 1.2

ReceiverThreads, 1.2

RecoveryThreads, 1.2

ReplicationApplyOrdering, 1.2

ReplicationParallelism, 1.2

ReplicationTrack, 1.2

サーバー接続属性, 1.2, 1.2

ServersPerDSN, 1.2

ServerStackSize, 1.2

SQLQueryTimeout, 1.2

TCP_Port, 1.2

TCP_Port2, 1.2

Temporary, 1.2

TempSize, 1.2

TempWarnThreshold, 1.2

TimesTen Cacheのデータベース属性, 1.2, 1.2

TimesTen Cacheの初期接続属性, 1.2, 1.2

TimesTen Cacheの一般接続属性, 1.2, 1.2

TTC_FailoverPortRange, 1.2

TTC_Server, 1.2

TTC_Server_DSN, 1.2

TTC_Server_DSN2, 1.2

TTC_Server2, 1.2

TTC_Timeout, 1.2

ttConfiguration組込みプロシージャ (値の確認), 2

TypeMode, 1.2

UID, 1.2

WaitForConnect, 1.2

ConnectionCharacterSet接続属性, 1.2 ConnectionName接続属性, 1.2 Connections接続属性, 1.2 一貫性チェック, ttCheckユーティリティ, 3.2.2 相関名, オプティマイザ, 2 作成, データベース

AutoCreate接続属性, 1.2

Overwrite接続属性, 1.2

PermSize接続属性, 1.2

Preallocate接続属性, 1.2

RecoveryThreads接続属性, 1.2

TempSize接続属性, 1.2

D

デーモン

管理, ttDaemonAdminユーティリティ, 3.2.2

ログ, ttDaemonLogユーティリティ, 3.2.2

Data Source Name接続属性, 1.2 データ・ストア属性, 1.2, 1.2 データ型, TypeMode接続属性, 1.2 DatabaseCharacterSet接続属性, 1.2 DataStore接続属性, 1.2 DDLCommitBehavior接続属性, 1.2 DDLReplicationAction接続属性, 1.2 DDLReplicationLevel接続属性, 1.2 Defaultオプティマイザ・フラグ, 2 Description接続属性, 1.2 破棄, ttDestroyユーティリティ, 3.2.2 Diagnostics接続属性, 1.2 ディスク領域, ファイル・システム, Preallocate接続属性, 1.2 Driver接続属性, 1.2 DuplicateBindMode接続属性, 1.2 永続コミット, ttDurableCommit組込みプロシージャ, 2 DurableCommits接続属性, 1.2 DynamicLoadEnable接続属性, 1.2 DynamicLoadEnableオプティマイザ・フラグ, 2 DynamicLoadErrorMode接続属性, 1.2 DynamicLoadErrorModeオプティマイザ・フラグ, 2

E

エラー・メッセージ, 最大長, 4.1

式, SELECT文, 最大, 4.1

F

ファイル・システムのディスク領域, Preallocate接続属性, 1.2

ファイル, オープン, 最大, 4.2

Firs tRowオプティマイザ・フラグ, 2

初期接続属性, 1.2, 1.2

固定長列, 最大長, 4.1

ForceCompileオプティマイザ・フラグ, 2

ForceConnect接続属性, 1.2

断片化

ttCompact組込みプロシージャでの排除, 2

ttCompactTS組込みプロシージャでの排除, 2

G

一般接続属性, 1.2, 1.2

GenPlanオプティマイザ・フラグ, 2

GlobalLocalJoinオプティマイザ・フラグ, 2

GlobalProcessingオプティマイザ・フラグ, 2

グリッド, キャッシュ, 「ttGridXXX組込みプロシージャ」を参照

GROUP BY句, 最大列, 4.1

H

Hashオプティマイザ・フラグ, 2

HashGbオプティマイザ・フラグ, 2

ホスト名

ttHostNameGet組込みプロシージャ, 2

ttHostNameSet組込みプロシージャ, 2

I

IF-THEN-ELSEコマンド, ttIsqlユーティリティ, 3.2.2

Index Advisor, 「ttIndexAdviceXXX組込みプロシージャ」を参照

IndexedORオプティマイザ・フラグ, 2

索引

列, 最大, 4.1

1つの表当たりの最大数, 4.1

RangeIndexType接続属性, 1.2

冗長索引の確認, 2

Isolation接続属性, 1.2

J

結合順序, 最大長, 4.1

L

制限, システム, 4

制限, 「最大」も参照

Oracleからのロード

ttIsqlのcreateandloadfromoraqueryコマンド, 3.2.2

ttLoadFromOracle組込みプロシージャ, 2

ttTableSchemaFromOraQueryGet組込みプロシージャ, 2

ロック, データベース

LockLevel接続属性, 1.2

LockWait接続属性, 1.2

ttLockLevel組込みプロシージャ, 2

ttLockWait組込みプロシージャ, 2

LockLevel接続属性, 1.2 LockWait接続属性, 1.2 ログ

バッファ・サイズ, LogBufMB接続属性, 1.2

デーモン, ttDaemonLogユーティリティ, 3.2.2

ディレクトリ, LogDir接続属性, 1.2

ファイル・サイズ, LogFileSize接続属性, 1.2

フラッシュ, LogFlushMethod接続属性, 1.2

保持, ttLogHolds組込みプロシージャ, 2

パラレル化, LogBufParallelism接続属性, 1.2

消去, LogPurge接続属性, 1.2

消去, MatchLogOpts接続属性, 1.2

LogAutoTruncate接続属性, 1.2 LogBufMB接続属性, 1.2 LogBufParallelism接続属性, 1.2 LogDir接続属性, 1.2 LogFileSize接続属性, 1.2 LogFlushMethod接続属性, 1.2 LogPurge接続属性, 1.2

M

MatchLogOpts接続属性, 1.2

MaxConnsPerServer接続属性, 1.2

最大

基本名, 長さ, 4.1

表当たりの列, 4.1

列, GROUP BY句, 4.1

列, ORDER BY句, 4.1

アプリケーションの同時接続, 4.1

クライアントの同時接続, 4.1

同時接続, 4.1

システムおよびアプリケーションの同時接続, 4.1

TimesTenインスタンスごとの共有メモリー・セグメントにおけるクライアントの同時接続, 4.1

データベース名, 長さ, 4.1

エラー・メッセージの長さ, 4.1

式, SELECT文, 4.1

オープン・ファイル, 4.2

固定長列, 長さ, 4.1

索引, 列数, 4.1

1つの表当たりの索引, 4.1

結合順序の長さ, 4.1

ネストされた副問合せ, 深度, 4.1

表当たりのパーティション, 4.1

パス名, 長さ, AWTキャッシュ・グループにおけるデータベース, 4.1

PL/SQLブロック, 最近使用した, キャッシュ済, 4.1

PL/SQL文, 準備済, 接続当たり, 4.1

述語文字列, SYS.PLAN表, 長さ, 4.1

プロパゲータ・データベース, 4.1

レプリケートされる列, 長さ, 4.1

行, 固定長列の累積長, 4.1

共有メモリー・セグメントのサイズ, クライアント接続, 4.1

SQL文, 長さ, 4.1

共有メモリー・セグメントごとの文ハンドル, クライアント接続, 4.1

サブスクライバ・データベース, 4.1

サブスクライバ・データベース, アクティブ・スタンバイ・ペア, 4.1

表参照, SQL問合せ, 4.1

可変長列, 長さ, 4.1

メモリー

メモリーが少ない場合の警告, ttWarnOnLowMemory組込みプロシージャ, 2

MemoryLock接続属性, 1.2

メモリー不足警告, PermWarnThreshold接続属性, 1.2

メモリー不足警告, TempWarnThreshold接続属性, 1.2

永続, PermSize接続属性, 1.2

一時, TempSize接続属性, 1.2

MemoryLock接続属性, 1.2 MergeJoinオプティマイザ・フラグ, 2 メトリック, 「ttStats」を参照 移行, ttMigrateユーティリティ, 3.2.2 データベースの最小サイズ, 4.1 マルチバイト・キャラクタ, パス名, サポート外, 4.3

N

名前

基本, 最大長, 4.1

データベース, 最大長, 4.1

NestedLoopオプティマイザ・フラグ, 2 ネストされた副問合せ, 最大深度, 4.1 NLS一般接続属性, 1.2, 1.2 NLS_LENGTH_SEMANTICS接続属性, 1.2 NLS_NCHAR_CONV_EXCP接続属性, 1.2 NLS_SORT接続属性, 1.2 NoRemRowIdOptオプティマイザ・フラグ, 2

O

オプティマイザ

相関名, 2

実行計画, 生成, ttOptUseIndex組込みプロシージャ, 2

ttOptSetOrder組込みプロシージャ, 2

オプティマイザ・フラグ

AllFlags, 2

BranchAndBound, 2

Default, 2

DynamicLoadEnable, 2

DynamicLoadErrorMode, 2

FirstRow, 2

ForceCompile, 2

GenPlan, 2

GlobalLocalJoin, 2

GlobalProcessing, 2

Hash, 2

HashGb, 2

IndexedOR, 2

MergeJoin, 2

NestedLoop, 2

NoRemRowIdOpt, 2

PassThrough, 2

Range, 2

Rowid, 2

RowLock, 2, 2

Scan, 2

設定, ttOptGetFlag組込みプロシージャ, 2

設定, ttOptSetFlag組込みプロシージャ, 2

ShowJoinOrder, 2

TblLock, 2, 2

TmpHash, 2

TmpRange, 2

TmpTable, 2

UseBoyerMooreStringSearch, 2

OracleNetServiceName接続属性, 1.2 OraclePWD接続属性, 1.2 ORDER BY句, 最大列, 4.1 Overwrite接続属性, 1.2

P

パラレル・レプリケーション

ReplicationApplyOrdering接続属性, 1.2

ReplicationParallelism接続属性, 1.2

パーティション, 表当たりの最大数, 4.1 PassThrough接続属性, 1.2 PassThroughオプティマイザ・フラグ, 2 パスワード

OraclePWD接続属性, 1.2

PWD接続属性, 1.2

PWDCrypt接続属性, 1.2

ttUserユーティリティ, 3.2.2

パス名

最大長, AWTキャッシュ・グループにおけるデータベース, 4.1

マルチバイト・キャラクタ, サポート外, 4.3

PermSize接続属性, 1.2 PermWarnThreshold接続属性, 1.2 PLSCOPE_SETTINGS接続属性, 1.2 PL/SQLブロック, 最近使用した, セッションごとにキャッシュされる最大数, 4.1 PLSQL接続属性, 1.2 PL/SQLの初期接続属性, 1.2, 1.2 PL/SQLの一般接続属性, 1.2, 1.2 PL/SQL文, 準備済, 接続当たりの最大数, 4.1 PLSQL_CCFLAGS接続属性, 1.2 PLSQL_MEMORY_ADDRESS接続属性, 1.2 PLSQL_MEMORY_SIZE接続属性, 1.2 PLSQL_OPTIMIZE_LEVEL接続属性, 1.2 PLSQL_TIMEOUT接続属性, 1.2 Preallocate接続属性, 1.2 述語文字列, SYS.PLAN表, 最大長, 4.1 PrivateCommands接続属性, 1.2 プロパゲータ・データベース, 最大, 4.1 PWD接続属性, 1.2 PWDCrypt接続属性, 1.2

Q

問合せ

ネストされた副問合せ, 最大深度, 4.1

計画, ttSQLCmdQueryPlan組込みプロシージャ, 2

表参照, 最大, 4.1

QueryThreshold接続属性, 1.2

R

RACCallback接続属性, 1.2

RAMポリシー, ttAdminユーティリティ, 3.2.2

RAMポリシー, 「ttRamPolicyXXX組込みプロシージャ」を参照

Rangeオプティマイザ・フラグ, 2

RangeIndexType接続属性, 1.2

ReceiverThreads接続属性, 1.2

RecoveryThreads接続属性, 1.2

レプリケートされる列, 最大長, 4.1

レプリケーション

DDLReplicationAction接続属性, 1.2

DDLReplicationLevel接続属性, 1.2

ポリシー, ttAdminユーティリティ, 3.2.2

ReceiverThreads接続属性, 1.2

ttCWAdminユーティリティ, 3.2.2

ttRepAdminユーティリティ, 3.2.2

レプリケーション, 「ttRepXXX組込みプロシージャ」も参照 ReplicationApplyOrdering接続属性, 1.2 ReplicationParallelism接続属性, 1.2 ReplicationTrack接続属性, 1.2 リストア, ttRestoreユーティリティ, 3.2.2 行, 固定長列の最大累積長, 4.1 Rowidオプティマイザ・フラグ, 2 行レベル・ロック, オプティマイザ・フラグ, 2, 2 RowLockオプティマイザ・フラグ, 2, 2

S

Scanオプティマイザ・フラグ, 2

スキーマ, ttSchemaユーティリティ, 3.2.2

SELECT文, 式, 最大, 4.1

サーバー接続属性, 1.2, 1.2

ServersPerDSN接続属性, 1.2

ServerStackSize接続属性, 1.2

セッション, PL/SQLブロック, 最近使用した, キャッシュされる最大数, 4.1

共有メモリー・セグメント

TimesTenインスタンスごとのクライアントの同時接続, 最大, 4.1

サイズ, 最大, クライアント接続, 4.1

ShowJoinOrderオプティマイザ・フラグ, 2 サイズ, データベース, 最小, 4.1 サイズ, 表

ttSize組込みプロシージャ, 2

ttSizeユーティリティ, 3.2.2

SQLコマンド・キャッシュ

問合せ計画, ttSQLCmdQueryPlan組込みプロシージャ, 2

ttSQLCmdCacheInfo組込みプロシージャ, 2

ttSQLCmdCacheInfo2組込みプロシージャ, 2

ttSQLCmdCacheInfoGet組込みプロシージャ, 2

ttSQLCmdQueryPlan組込みプロシージャ, 2

SQL問合せ, 表参照, 最大, 4.1 SQL文, 最大長, 4.1 SQLQueryTimeout接続属性, 1.2 文ハンドル, 共有メモリー・セグメントごとの最大, クライアント接続, 4.1 文, SQL, 最大長, 4.1 統計

統計の消去, ttOptClearStats組込みプロシージャ, 2

構成, ttStatsConfig組込みプロシージャ, 2

推定, ttOptEstimateStats組込みプロシージャ, 2

取得, ttOptGetColStats組込みプロシージャ, 2

明示的に変更 (列), ttOptSetColIntvlStats組込みプロシージャ, 2

明示的に変更 (列), ttOptSetColStats組込みプロシージャ, 2

明示的に変更 (表), ttOptSetTblStats組込みプロシージャ, 2

PL/SQLメモリー, ttPLSQLMemoryStats組込みプロシージャ, 2

TBL_STATSシステム表およびCOL_STATSシステム表, 2

ttStatsユーティリティ, 3.2.2

明示的に更新, ttOptUpdateStats組込みプロシージャ, 2

状態

ttDataStoreStatus組込みプロシージャ, 2

ttStatusユーティリティ, 3.2.2

副問合せ, ネスト, 最大深度, 4.1 サブスクライバ・データベース

最大, 4.1

最大, アクティブ・スタンバイ・ペア, 4.1

syslog (UNIX), 3.2.2 SYS.PLAN表, 述語文字列, 最大長, 4.1 システム表ID, XLA, ttSetUserTableID組込みプロシージャ, 2

T

表

列, 最大, 4.1

索引, 最大, 4.1

パーティション, 最大, 4.1

参照, SQL問合せ, 最大, 4.1

サイズ, ttSize組込みプロシージャ, 2

サイズ, ttSizeユーティリティ, 3.2.2

TBL_STATSシステム表, 2 TblLockオプティマイザ・フラグ, 2, 2 TCP_Port接続属性, 1.2 TCP_Port2接続属性, 1.2 Temporary接続属性, 1.2 一時データベース, Temporary接続属性, 1.2 TempSize接続属性, 1.2 TempWarnThreshold接続属性, 1.2 スレッド

ReceiverThreads接続属性, 1.2

RecoveryThreads接続属性, 1.2

タイムアウト

PLSQL_TIMEOUT接続属性, 1.2

SQLQueryTimeout接続属性, 1.2

TTC_Timeout接続属性, 1.2

TimesTen Cacheのデータベース属性, 1.2, 1.2 TimesTen Cacheの初期接続属性, 1.2, 1.2 TimesTen Cacheの一般接続属性, 1.2, 1.2 TmpHashオプティマイザ・フラグ, 2 TmpRangeオプティマイザ・フラグ, 2 TmpTableオプティマイザ・フラグ, 2 トレース

有効化/無効化, ttTraceMonユーティリティ, 3.2.2

情報表示, ttTailユーティリティ, 3.2.2

トランザクション

管理, ttXactAdminユーティリティ, 3.2.2

コミット, DDLCommitBehavior接続属性, 1.2

コミット, DurableCommits接続属性, 1.2

ID, ttXactIdGet組込みプロシージャ, 2

ログ, ttXactLogユーティリティ, 3.2.2

トランザクション・ログAPI, 「XLA」を参照 ttAdminユーティリティ, 3.2.2 ttAdoptStoresユーティリティ, 3.2.2 ttAgingLRUConfig組込みプロシージャ, 2 ttAgingScheduleNow組込みプロシージャ, 2 ttApplicationContext組込みプロシージャ, 2 ttBackupユーティリティ, 3.2.2 ttBackupStatus組込みプロシージャ, 2 ttBlockInfo組込みプロシージャ, 2 ttBookmark組込みプロシージャ, 2 ttBulkCpユーティリティ, 3.2.2 TTC_FailoverPortRange接続属性, 1.2 TTC_Server接続属性, 1.2 TTC_Server_DSN接続属性, 1.2 TTC_Server_DSN2接続属性, 1.2 TTC_Server2接続属性, 1.2 TTC_Timeout接続属性, 1.2 ttCacheAdvisorユーティリティ, 3.2.2 ttCacheAllowFlushAwtSet組込みプロシージャ, 2 ttCacheAutorefIntervalStatsGet組込みプロシージャ, 2 ttCacheAutorefresh組込みプロシージャ, 2 ttCacheAutorefreshLogDefrag組込みプロシージャ, 2 ttCacheAutorefreshSelectLimit組込みプロシージャ, 2 ttCacheAutorefreshStatsGet組込みプロシージャ, 2 ttCacheAutorefreshXactLimit組込みプロシージャ, 2 ttCacheAWTMonitorConfig組込みプロシージャ, 2 ttCacheAWTThresholdGet組込みプロシージャ, 2 ttCacheAWTThresholdSet組込みプロシージャ, 2 ttCacheCheck組込みプロシージャ, 2 ttCacheConfig組込みプロシージャ, 2 ttCacheDbCgStatus組込みプロシージャ, 2 ttCachePolicyGet組込みプロシージャ, 2 ttCachePolicySet組込みプロシージャ, 2 ttCachePropagateFlagSet組込みプロシージャ, 2 ttCacheSqlGet組込みプロシージャ, 2 ttCacheStart組込みプロシージャ, 2 ttCacheStop組込みプロシージャ, 2 ttCacheUidGet組込みプロシージャ, 2 ttCacheUidPwdSet組込みプロシージャ, 2 ttCaptureユーティリティ, 3.2.2 ttCheckユーティリティ, 3.2.2 ttCkpt組込みプロシージャ, 2 ttCkptBlocking組込みプロシージャ, 2 ttCkptConfig組込みプロシージャ, 2 ttCkptHistory組込みプロシージャ, 2 ttCommitBufferStats組込みプロシージャ, 2 ttCommitBufferStatsReset組込みプロシージャ, 2 ttCompact組込みプロシージャ, 2 ttCompactTS組込みプロシージャ, 2 ttComputeTabSizes組込みプロシージャ, 2 ttConfiguration組込みプロシージャ, 2 ttContext組込みプロシージャ, 2 ttCWAdminユーティリティ, 3.2.2 ttDaemonAdminユーティリティ, 3.2.2 ttDaemonLogユーティリティ, 3.2.2 ttDataStoreStatus組込みプロシージャ, 2 ttDBConfig組込みプロシージャ, 2 ttDbWriteConcurrencyModeGet組込みプロシージャ, 2 ttDbWriteConcurrencyModeSet組込みプロシージャ, 2 ttDestroyユーティリティ, 3.2.2 ttDurableCommit組込みプロシージャ, 2 ttGridAttach組込みプロシージャ, 2 ttGridCheckOwner組込みプロシージャ, 2 ttGridCreate組込みプロシージャ, 2 ttGridDestroy組込みプロシージャ, 2 ttGridDetach組込みプロシージャ, 2 ttGridDetachAll組込みプロシージャ, 2 ttGridDetachList組込みプロシージャ, 2 ttGridFirstMemberAttach組込みプロシージャ, 2 ttGridGlobalCGResume組込みプロシージャ, 2 ttGridGlobalCGSuspend組込みプロシージャ, 2 ttGridInfo組込みプロシージャ, 2 ttGridNameSet組込みプロシージャ, 2 ttGridNodeStatus組込みプロシージャ, 2 ttHostNameGet組込みプロシージャ, 2 ttHostNameSet組込みプロシージャ, 2 ttIndexAdviceCaptureDrop組込みプロシージャ, 2 ttIndexAdviceCaptureEnd組込みプロシージャ, 2 ttIndexAdviceCaptureInfoGet組込みプロシージャ, 2 ttIndexAdviceCaptureOutput組込みプロシージャ, 2 ttIndexAdviceCaptureStart組込みプロシージャ, 2 ttIsqlユーティリティ, 3.2.2 ttLoadFromOracle組込みプロシージャ, 2 ttLockLevel組込みプロシージャ, 2 ttLockWait組込みプロシージャ, 2 ttLogHolds組込みプロシージャ, 2 ttMigrateユーティリティ, 3.2.2 ttmodinstallユーティリティ, 3.2.2 ttMonitorHighWaterReset組込みプロシージャ, 2 ttOptClearStats組込みプロシージャ, 2 ttOptCmdCacheInvalidate組込みプロシージャ, 2 ttOptEstimateStats組込みプロシージャ, 2 ttOptGetColStats組込みプロシージャ, 2 ttOptGetFlag組込みプロシージャ, 2 ttOptGetMaxCmdFreeListCnt組込みプロシージャ, 2 ttOptGetOrder組込みプロシージャ, 2 ttOptSetColIntvlStats組込みプロシージャ, 2 ttOptSetColStats組込みプロシージャ, 2 ttOptSetFlag組込みプロシージャ, 2 ttOptSetMaxCmdFreeListCnt組込みプロシージャ, 2 ttOptSetMaxPriCmdFreeListCnt組込みプロシージャ, 2 ttOptSetOrder組込みプロシージャ, 2 ttOptSetTblStats組込みプロシージャ, 2 ttOptShowJoinOrder組込みプロシージャ, 2 ttOptStatsExport組込みプロシージャ, 2 ttOptUpdateStats組込みプロシージャ, 2 ttOptUseIndex組込みプロシージャ, 2 ttPLSQLMemoryStats組込みプロシージャ, 2 ttRamPolicyAutoReloadGet組込みプロシージャ, 2 ttRamPolicyAutoReloadSet組込みプロシージャ, 2 ttRamPolicyGet組込みプロシージャ, 2 ttRamPolicySet組込みプロシージャ, 2 ttRedundantIndexCheck組込みプロシージャ, 2 ttRepAdminユーティリティ, 3.2.2 ttRepDeactivate組込みプロシージャ, 2 ttReplicationStatus組込みプロシージャ, 2 ttRepPolicyGet組込みプロシージャ, 2 ttRepPolicySet組込みプロシージャ, 2 ttRepQueryThresholdGet組込みプロシージャ, 2 ttRepQueryThresholdSet組込みプロシージャ, 2 ttRepStart組込みプロシージャ, 2 ttRepStateGet組込みプロシージャ, 2 ttRepStateSave組込みプロシージャ, 2 ttRepStateSet組込みプロシージャ, 2 ttRepStop組込みプロシージャ, 2 ttRepSubscriberStateSet組込みプロシージャ, 2 ttRepSubscriberWait組込みプロシージャ, 2 ttRepSyncGet組込みプロシージャ, 2 ttRepSyncSet組込みプロシージャ, 2 ttRepSyncSubscriberStatus組込みプロシージャ, 2 ttRepTransmitGet組込みプロシージャ, 2 ttRepTransmitSet組込みプロシージャ, 2 ttRepXactStatus組込みプロシージャ, 2 ttRepXactTokenGet組込みプロシージャ, 2 ttRestoreユーティリティ, 3.2.2 ttSchemaユーティリティ, 3.2.2 ttSetUserColumnID組込みプロシージャ, 2 ttSetUserTableID組込みプロシージャ, 2 ttSize組込みプロシージャ, 2 ttSizeユーティリティ, 3.2.2 ttSQLCmdCacheInfo組込みプロシージャ, 2 ttSQLCmdCacheInfo2組込みプロシージャ, 2 ttSQLCmdCacheInfoGet組込みプロシージャ, 2 ttSQLCmdQueryPlan組込みプロシージャ, 2 ttSQLExecutionTimeHistogram組込みプロシージャ, 2 ttStatsユーティリティ

説明, 3.2.2

例, 監視, 3.2.2

例, スナップショット, 3.2.2

例, レポート, 3.2.2

ttStatsConfig組込みプロシージャ, 2 ttStatusユーティリティ, 3.2.2 ttSysLogCheckユーティリティ, 3.2.2 ttTableSchemaFromOraQueryGet組込みプロシージャ, 2 ttTailユーティリティ, 3.2.2 ttTraceMonユーティリティ, 3.2.2 ttUserユーティリティ, 3.2.2 ttVersion組込みプロシージャ, 2 ttVersionユーティリティ, 3.2.2 ttWarnOnLowMemory組込みプロシージャ, 2 ttXactAdminユーティリティ, 3.2.2 ttXactIdGet組込みプロシージャ, 2 ttXactLogユーティリティ, 3.2.2 ttXlaBookmarkCreate組込みプロシージャ, 2 ttXlaBookmarkDelete組込みプロシージャ, 2 ttXlaSubscribe組込みプロシージャ, 2 ttXlaUnsubscribe組込みプロシージャ, 2 TypeMode接続属性, 1.2

U

UID接続属性, 1.2

UseBoyerMooreStringSearchオプティマイザ・フラグ, 2

ユーザー表ID, XLA, ttSetUserTableID組込みプロシージャ, 2

ユーティリティ

アクセス制御, 3.2.1

認証, 1.2, 3.2.1

権限, 3.2.1

ttAdmin, 3.2.2

ttAdoptStores, 3.2.2

ttBackup, 3.2.2

ttBulkCp, 3.2.2

ttCacheAdvisor, 3.2.2

ttCapture, 3.2.2

ttCheck, 3.2.2

ttCWAdmin, 3.2.2

ttDaemonAdmin, 3.2.2

ttDaemonLog, 3.2.2

ttDestroy, 3.2.2

ttIsql, 3.2.2

ttMigrate, 3.2.2

ttmodinstall, 3.2.2

ttRepAdmin, 3.2.2

ttRestore, 3.2.2

ttSchema, 3.2.2

ttSize, 3.2.2

ttStats, 3.2.2

ttStatus, 3.2.2

ttSysLogCheck, 3.2.2

ttTail, 3.2.2

ttTraceMon, 3.2.2

ttUser, 3.2.2

ttVersion, 3.2.2

ttXactAdmin, 3.2.2

ttXactLog, 3.2.2

V

可変長列, 最大長, 4.1

バージョン, TimesTen

ttVersion組込みプロシージャ, 2

ttVersionユーティリティ, 3.2.2

W

WaitForConnect接続属性, 1.2

WHENEVER SQLERRORコマンド, ttIsqlユーティリティ, 3.2.2

X

XLA

ブックマーク, 管理, ttIsqlユーティリティ, 3.2.2

列ID, ttSetUserColumnID組込みプロシージャ, 2

システム表ID, ttSetUserTableID組込みプロシージャ, 2

ttBookmark組込みプロシージャ, 2

ttXlaBookMarkCreate組込みプロシージャ, 2

ttXlaBookmarkDelete組込みプロシージャ, 2

ttXlaSubscribe組込みプロシージャ, 2

ttXlaUnsubscribe組込みプロシージャ, 2

ユーザー表ID, ttSetUserTableID組込みプロシージャ, 2

オラクル社の法律上の注意点について

コピーライトについて

Copyright © 1994-2015, Oracle and/or its affiliates.All rights reserved.

商標と登録商標について

OracleおよびJavaはOracle Corporationおよびその関連企業の登録商標です。その他の名称は、それぞれの所有者の商標または登録商標です。

Intel、Intel Xeonは、Intel Corporationの商標または登録商標です。すべてのSPARCの商標はライセンスをもとに使用し、SPARC International, Inc.の商標または登録商標です。AMD、Opteron、AMDロゴ、AMD Opteronロゴは、Advanced Micro Devices, Inc.の商標または登録商標です。UNIXは、The Open Groupの登録商標です。

ライセンス制約の保証と結果的に生じる損害の免責

このソフトウェアおよび関連ドキュメントの使用と開示は、ライセンス契約の制約条件に従うものとし、知的財産に関する法律により保護されています。ライセンス契約で明示的に許諾されている場合もしくは法律によって認められている場合を除き、形式、手段に関係なく、いかなる部分も使用、複写、複製、翻訳、放送、修正、ライセンス供与、送信、配布、発表、実行、公開または表示することはできません。このソフトウェアのリバース・エンジニアリング、逆アセンブル、逆コンパイルは互換性のために法律によって規定されている場合を除き、禁止されています。

保証免責

ここに記載された情報は予告なしに変更される場合があります。また、誤りが無いことの保証はいたしかねます。誤りを見つけた場合は、オラクル社までご連絡ください。

制限付権利

このソフトウェアまたは関連ドキュメントを、米国政府機関もしくは米国政府機関に代わってこのソフトウェアまたは関連ドキュメントをライセンスされた者に提供する場合は、次の通知が適用されます。

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations.As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs.No other rights are granted to the U.S. Government.

危険な用途への使用について

このソフトウェアもしくはハードウェアは様々な情報管理アプリケーションでの一般的な使用のために開発されたものです。このソフトウェアもしくはハードウェアは、危険が伴うアプリケーション（人的傷害を発生させる可能性があるアプリケーションを含む）への用途を目的として開発されていません。このソフトウェアもしくはハードウェアを危険が伴うアプリケーションで使用する際、安全に使用するために、適切な安全装置、バックアップ、冗長性（redundancy）、その他の対策を講じることは使用者の責任となります。このソフトウェアもしくはハードウェアを危険が伴うアプリケーションで使用したことに起因して損害が発生しても、オラクル社およびその関連会社は一切の責任を負いかねます。

第三者のコンテンツ、製品、サービスに対する免責事項

このソフトウェアまたはハードウェア、そしてドキュメントは、第三者のコンテンツ、製品、サービスへのアクセス、あるいはそれらに関する情報を提供することがあります。オラクル社およびその関連会社は、第三者のコンテンツ、製品、サービスに関して一切の責任を負わず、いかなる保証もいたしません。オラクル社およびその関連会社は、第三者のコンテンツ、製品、サービスへのアクセスまたは使用によって損失、費用、あるいは損害が発生しても一切の責任を負いかねます。

ドラフトのアルファ版およびベータ版ドキュメントについて

このドキュメントが試作版の場合:

このドキュメントは試作版であり、デモおよび暫定使用のみを目的としたものです。このソフトウェアを使用するハードウェアに限定するものではありません。オラクル社およびその関連会社は、このドキュメントに関して一切の責任を負わず、いかなる保証もいたしません。また、このドキュメントを使用したことによって損失、費用、あるいは損害が発生しても、一切の責任を負いかねます。