Caché 2007.1

EnableLongStrings 構成パラメータ

Caché では、文字列操作の結果を保存するために、一定容量を持つ領域が割り当てられます。この領域は文字列スタックと呼ばれます。割り当てられた容量を超える文字列式が発生すると、<STRINGSTACK> エラーとなります。既存のアプリケーションでは、これは問題になりません。しかし、このリリースから Caché 文字列の最大長が増加されたので、この長い文字列使用を試みるアプリケーションでは、この機能が有効化されていない場合に問題が発生する可能性があります。

ホーム, 構成, 詳細設定 の [その他] カテゴリにある構成パラメータ EnableLongStrings を有効にしている場合は、長い文字列を使用する操作に対応するために、文字列スタックのサイズを約 50 倍にしてください。

システム全体の設定では、キャッシングは有効です。Caché ジョブは、長い文字列を使用するべきかどうか判定するときにこのスイッチをチェックし、大きなサイズの (長い文字列をサポートする) 文字列スタックまたは通常の文字列スタックを必要に応じて割り当てます。$zu(69, 69) を使用して、プログラムがスイッチ設定を変更する場合がありますが、現在のジョブには影響しません。後続のジョブのみが、変更された設定を使用します。ジョブが文字列スタックを割り当てた後は、同じジョブでサイズを後から変更できません。

%SYS.LDAP の追加

このクラス %SYS.LDAPOpens in a new tab は、ObjectScript インタフェースを LDAP データベースに提供して、LDAP (Lightweight Directory Access Protocol) を使用するシステムの管理を支援するために提供されています。呼び出し元は、提供されたメソッドを使用してデータベースにアクセスするために自己認証を行います。認証されると、LDAP データベースから項目を追加および削除でき、LDAP によって管理される情報を検索できます。

ジャーナリング API への変更

トランザクション・ロールバックまたはクラッシュ回復に必要なファイルを除き、すべてのジャーナル・ファイルを削除するために、%SYS.JournalFile API が実装されました。

##class(%SYS.Journal.File).PurgeAll()

クラッシュ回復とは、Cache 起動またはクラスタ・フェイルオーバー復元の一部として実行されるジャーナルのリストア作業のことです。

WARNING:

バックアップ後のジャーナル・ファイルは、必ずしも保持されるわけではありません。したがって、バックアップと後続のジャーナル・ファイルからデータベースをリストアする場合、バックアップに基づくジャーナル削除パラメータを構成し、定期削除 API (PURGE^JRNUTIL) を使用する必要があります。

また、Cache 構成の条件とは異なる条件に基づくジャーナル・ファイルを削除するための API もあります。

##class(%SYS.Journal.File).Purge(NDaysOld As %Integer,
                                 NBackupsOld As %Integer) returns %Status 

この方法では、指定された条件に基づいて古いジャーナル・ファイルを削除し、トランザクション・ロールバックやクラッシュ回復に必要なファイルを削除しません。 パラメータは以下のとおりです。

• NDaysOld – ジャーナル・ファイルを削除するには、作成からこの日数以上経過していなければなりません。

• NBackupsOld – ジャーナル・ファイルを削除するには、この数以上バックアップされていなければなりません。

両方のパラメータを指定した場合、いずれか一方の条件のみ満たしていれば (包含的論理和)、ロール・バックとクラッシュ回復に関する制限に従ってジャーナル・ファイルを削除できます。

一般メモリ・ヒープ構成 API の追加

Caché がヒープを使用する方法に関する情報を収集するために、新規 API、%SYSTEM.Config.SharedMemoryHeapOpens in a new tab が追加されました。構成で使用するために利用可能な一般メモリ・ヒープと推奨の gmheap パラメータを取得する機能も提供されています。例えば、DisplayUsage メソッドは、各システム・コンポーネントによって使用されるすべてのメモリと、利用可能なヒープ･メモリの容量を表示します。

Write $SYSTEM.Config.SharedMemoryHeap.DisplayUsage()

RecommendedSize メソッドは、スムーズな処理を実行するために、このインスタンスで構成される必要があるヒープ・メモリの推奨容量を返します。

Write $SYSTEM.Config.SharedMemoryHeap.RecommendedSize()

IntegrityList メソッドの削除

メソッド IntegrityList は使用可能な既存機能と重複するため、%SYS.GlobalQueryOpens in a new tab クラスから削除されました。同一の目的を達成するには、以下に示す既存の各メソッドを使用できます。

Windows

• インストーラの変更

  • 今回のリリースでは、Windows にインストールした場合の既定のインストール・ディレクトリが C:\InterSystems\Cache に変更されています。

  • 互換性上の理由から、Caché を Program Files ディレクトリへインストールできなくなりました。

  • 既定のインストール・ディレクトリの変更に伴い、エントリ %SystemRoot%\InterSystems\Common Files\intersystems\cache が追加されます。このエントリは、システム全体に影響する環境変数 Path の末尾に付け加えられます。このディレクトリには、Caché 固有の DLL が保存されます。

• Vista 使用時に必要な変更

  • オペレーティング・システムのアップグレードによる新しい Caché バージョンのインストールの必要性 — Windows Vista では、プログラムの上位互換性に関する重大な問題が発生します。そのため、既に Caché がインストールされているシステムを Vista にアップグレードすると、ほとんどの場合 Caché が正常に動作しなくなります。

    インターシステムズは、Vista の使用を希望されるお客様には、新しい Caché バージョンのインストールをお願いしています。既存のデータとアプリケーションは、該当するデータベースの保存およびリストアにより移動できます。アプリケーションはリコンパイルが必要です。

  • セキュリティの調整 — 選択したオプションによっては、Caché のインストール後に、手動での追加調整が必要となる場合があります。詳細は、"Caché インストール・ガイド" の “Microsoft Windows への Caché のインストール” の章を参照してください。

  • プロトコルの制約 — Caché は、Windows Vista 上では、Raw Ethernet を使用した DDP、LAT、または DCP をサポートしません。詳細は、"サポート対象プラットフォーム" を参照してください。

  • CacheODBC ログの既定場所の変更 — 現在、ログの既定の場所は %PUBLIC%\Logs\CacheODBC.log となっています。このディレクトリにはすべてのユーザがアクセスでき、ログの作成場所を 1 か所に集約できるメリットがあります。以前の場所は %WINDIR% でした。Vista では、これは C:\users\someuser\AppData\Local\VirtualStore\Windows\CacheODBC.log に仮想化されます。その結果、ログの場所がユーザごとに異なり、問題解決に際してログの利用が困難になります。

    ログ･ファイルの場所を変更するには、新しい場所を環境変数 CACHEODBCTRACEFILE に設定します。

  • 起動時の暗号化オプションの Windows Vista における細部的な相違 — インスタンスがデータベースの暗号化を使用し、インタラクティブにキーを有効化する起動をサポートする場合、Caché により暗号化キー情報が要求されます。Vista 上では、この要求により [対話型サービス ダイアログの検出] ダイアログ･ボックスが表示されます。このダイアログのウィンドウは初期状態では最小化されるため、Vista のタスクバーが非表示に構成されている場合、このダイアログ･ボックスに気付かないことがあります。詳細は、"Caché セキュリティ管理ガイド" の "データベース暗号化" の章を参照してください。

共有メモリに対して大きなページ・サイズを使用する – Windows Server SP1

Caché for Windows は、共有メモリ・セクションに Windows の大きなページを使用できるように強化されています。大きなページは、共有メモリ・セクションの割り当て時に、ソフトウェア・アプリケーションに対して Windows がアクセス可能にするハードウェア機能で、Server 2003, SP1 から利用可能となっています。実際のページのサイズは、使用するプロセッサによって異なります。認識されているプロセッサとそれらの大きなページ・サイズは以下のとおりです。

• EMT 64 ビット ： 2 MB

• AMD 64 ビット ： 2 MB

• Itanium ： 16 MB

Windows のこの機能が使用可能で、Caché を起動するプロセスが SeLockMemoryPrivilege リソースを取得できるときは、Caché は最初に大きなページの使用を試みます。大きなバッファ･プールを割り当てるシステムでは、バッファ･プールが物理メモリにロックされハードウェア変換バッファの使用効率が向上するため、パフォーマンスが強化されます。大きなページは物理メモリにロックされるため、バッファ･プールの要求が大きくなりすぎないように注意する必要があります。マシンでサポートが必要なユーザ数に対して、十分な物理メモリが残らなくなる可能性があるためです。この状態、つまりメモリ不足状態になると、バッファ･プールに通常サイズのページが使用されている場合よりパフォーマンスが悪化します。

Windows では、ユーザ用に残しておく物理メモリ量を計算するときに、Windows がメモリ管理の構成要素として作成するページ・テーブル・エントリを考慮する必要があります。ページ・テーブル・エントリ (PTE) は、32 ビット・システムではそれぞれ 4 バイトを、64 ビット・システムでは 8 バイトを消費します。Windows は、4KB のメモリごとに 1 つのページ・テーブル・エントリを割り当てます。これは、64 ビット・システムでは、共有メモリ・セクションのサイズを 500 で除算することで、Windows が共有メモリ・セクションとのマップ用に PTE に割り当てるおよそのバイト数が算出されることを意味します。このメモリはプロセスごとにプライベートのため、各プロセスがこれだけのメモリをまとめて割り当てる必要があります。

PTE はページング可能なため、PTE の管理自体がパフォーマンス上の問題となる場合があります。PTE に対して必要な物理メモリが確保されるように注意する必要があります。PTE はそれが参照する物理メモリがアクセスされるまではページ・アウト状態にあるため、当初はこの問題は顕在化しません。そのため、システムは問題なく動作しているように見えますが、時間が経過し需要が増すにつれてパフォーマンスは大幅に悪化します。

ほとんどのプラットフォームでは、Caché が起動したときに、グローバルおよびルーチン・バッファ用に要求された共有メモリの割り当てに失敗すると、要求する容量を毎回減らしながら何度か要求を再試行します。この状態は、割り当てに成功するか、再試行回数の上限に達するまで繰り返されます。後者の場合は、メッセージがログに記録され、起動が中止されます。

Windows では、このアプローチは 2 つのフェーズを介して進行します。最初、Caché は大きなページがサポートされていると想定して、大きなページの使用を試みます。起動プロセスが必要な権限の取得を試み、要求のループを実行します。割り当てに成功した場合は、メモリ管理に大きなページの使用が開始されます。大きなページの使用に失敗した場合は、大きなページを使用しない元のメモリ要求に基づいてループが再実行されます。このループの 2 回目の繰り返しに失敗した場合、Caché は起動に失敗します。

リモート・データベースのパス名

以前のバージョンでは、アップグレードにより、リモート・データベースのドライブ文字が大文字に変更されました。この変更は実行されなくなりました。Windows ECP サーバを使用するサイトは、ホーム, 構成, リモート・データベース でリモート・データベースのパス名を調べる必要があります。ドライブ文字が大文字のパス名があれば、小文字に変更する必要があります。

UNIX®/Linux/Mac OS X

• デーモンの特権

  5.1 よりも前のバージョンの Caché では、デーモンは必ず root として実行され、Caché はその特権を使用して UNIX® パラメータ RLIMIT_FSIZE を無制限に設定していました。一方、5.1 以降では、Caché デーモンは root 以外のユーザ ID でも実行できます。root は自身の制限のみを設定できるので、この制限は非 root 所有者に対しては設定できません。

  また、非 root ユーザとして実行されているとき、Caché は現在の制限 (ソフト) のハード制限への設定変更に失敗しています。 この場合は、RLIMIT_FSIZE のハード制限が無制限であっても、Caché がソフト制限が低い値に設定されたログイン・ユーザから起動されていれば、Caché デーモンはこの低い値を使用して実行され、CACHE.DAT または CACHE.WIJ への書き込みを試みる重大な I/O エラーが生じる可能性がありました。

  今回の Cache では、RLIMIT_FSIZE のハード制限が無制限になっていることが確認され、そうでない場合は、エラー・メッセージと共に Cache の起動 (またはインストール) が中断されます。 次に、Cache はそのデーモンの中でソフト制限をハード制限に設定します。

• Mac OS X での CDL サポートの終了

  今回のバージョンの Caché では、Mac プラットフォームでの CDL のサポートが廃止されました。プラットフォーム間でのアプリケーションの転送には XML をご使用ください。

機能 ： xDBC

このバージョンの Caché を実行するサーバ・システムへの接続を試みるクライアント・アプリケーションは、Caché バージョン 5.0.13 以降で実行する必要があります。それ以前のバージョンからの接続は失敗します。

利用するサイトでこれが問題となる場合は、インターシステムズのサポート窓口Opens in a new tabにお問い合わせください。

Dreamweaver のサポート終了

このリリースの Caché では、CSP ページ生成の方法として、どのバージョンの Dreamweaver も使用できなくなりました。

Python バインディングのバージョン要件

Windows 上の Caché バージョン 2007.1 で、Python 言語バインディングの使用を希望されるお客様は、Microsoft Visual Studio 7 と共に ActiveState Python 2.4 を使用することをお勧めします。インターシステムズでは、製品のテストに ActiveState Python 2.4.3.12 を使用しています。

パターン・マッチングの変更

このリリースでは、パターンのマッチング方法に対して互換性がありません。一定の特性を備えたパターンを使用しているアプリケーションは、このバージョンでリコンパイルする必要があります。リコンパイルしないと、誤った結果が得られます。そのような特性は以下のとおりです。

• 反復回数が 12 である (“X?12N” など)。

• 反復範囲の最初の数が 12 である (“X?12.14N” など)。

• 反復範囲を指定する 2 つの数の差が 12 である (“X?3.15N”、“X?.12N” など)。

Caché SQL NOT! および NOT& 演算子の削除

今回のリリースの Caché では、FDBMS 時代の演算子 NOT! および NOT& は SQL 構文から完全に削除されます。利用するアプリケーションでこれが問題となる場合は、インターシステムズのサポート窓口Opens in a new tabにお問い合わせください。

SYSDATE は予約語に

アプリケーションを Caché に移行しているユーザへの支援として、SQL では関数 SYSDATE をサポートするようになりました。この関数よりも、これと同等の SQL 標準関数 CURRENT_TIMESTAMP の使用が推奨されます。

CREATE TABLE による既定のスキーマ割り当ての変更

Caché SQL では、スキーマ名 USER を使って定義された既定のパッケージはありません。USER に対するパッケージ定義が存在しないときに、スキーマ名 USER を使用してテーブルを作成しようとすると、USER というパッケージとスキーマ名を使ったパッケージ・マッピングが作成されます。

これにより、SQLUser (スキーマ) マッピングに対する USER パッケージの既定のマッピングがオーバーライドされます。

また、USER は SQL 予約語ですが、従来のリリースにあいまいさがなかったので、SQL パーサでは USER はスキーマ名と見なされます。

Caché 2007.1 では、USER は区切り文字付き識別子である場合を除き、DDL 文のスキーマ名として使用できなくなります。これにより、テーブルの任意の DDL 開発や、その他の SQL オブジェクトによる Caché の既定のマッピング (User->SQLUser) をオーバーライドするパッケージ・マッピングの作成が阻止されます。区切り文字を付けずに USER を使用すると、新たな SQL エラーが発生します。

SQLCODE = -312: Invalid schema name 'USER'

Oracle の Timestamp と JDBC ゲートウェイ

Oracle Date として定義されている Oracle データベース列にリンクしたとき、その列値がリンク・プロシージャによって Caché Date として正しく表現されません。この解釈の結果として、Date (実際は Timestamp) として宣言されているデータ項目は JDBC 経由で操作できません。

正しい動作を実現するには、テーブルのリンク後に、ユーザがスタジオでクラス定義を開いて、そのデータ型を %Date から %TimeStamp に変更する必要があります。

これは、Oracle JDBC ドライバに関する解決済みの既知の問題Opens in a new tabです。

TuneTable と KeepUpToDate フラグ

Caché には、テーブルのコンテンツに関する統計を収集し、クエリの最適化に役立てる機能があります。実行時にアプリケーションから呼び出し可能なメソッドは $SYSTEM.SQL.TuneTable です。

この $SYSTEM.SQL.TuneTable の 5 番目のパラメータが KeepUpToDate フラグです。このフラグを 1 に設定すると、Caché は、ExtentSize の値と Selectivity の変更時にクラスとテーブルを有効期限切れとしてマークしなくなります。

バージョン 2007.1 では、KeepUpToDate はクエリ・キャッシュにも効果を及ぼすように拡張されています。KeepUpToDate を 1 に設定すると、Caché は、TuneTable の操作の一環としてクエリ・キャッシュを削除しなくなります。

このフラグの既定は 0 で、その場合、クラスは最新でないとしてマークされ、テーブルに依存するすべてのクエリ・キャッシュが削除されます。KeepUpToDate が 0 に設定されている実働システムで TuneTable を実行した場合、キャッシュから削除されたクエリをアプリケーションが使用するとアプリケーション・エラーとなります。

Sybase および SQL Server との互換性に関する変更

Sybase および SQL Server との互換性に関して、以下の変更が行われています。

• コマンド TRUNCATE TABLE が追加されました。

• 5 つの新しい関数 (CHARINDEX、DATALENGTH、REPLACE、STUFF、SYSDATE) を式で使用できるようになりました。

• 新しい 2 つの予約語 SYSDATE および STATISTICS が追加されました。

新しい DDL データ型のマッピング

今回のバージョンでは、データ型マッピングのシステム・リストに以下の新しいデータ型マッピングが追加されました。

文の変更

以下は、文構文に対する変更の要約です。詳細は、"SQL リファレンス" を参照してください。

• INSERT 文で INTO キーワードがオプションになりました。

• UPDATE および DELETE 文で、マルチテーブル選択条件をサポートする新しい FROM 節が使用可能になりました。

• DELETE 文で FROM キーワードがオプションになりました。

演算子および述語の変更

以下はバージョン 2007.1 で新たに追加されました。

• LIKE 述語の大文字/小文字照合のサポート

• 新しい比較演算子としての %CONTAINSTERM の追加

新しいコマンド構文

Caché SQL では、Caché Objectscript で使用するのと同じ /* ... */ 構文による複数行のコメントをサポートするようになりました。

文字列のトランケーション

一部の状況で Caché が最大文字列長の設定を無視していたエラーが修正されました。これまで、最大長を超える文字列は、文字列長の超過が検出されずに、そのまま受け入れられていました。これらの値は、ストアド・プロシージャに渡したり永続化するなどのその後の使用時に、正しくトランケーションされました。今回の修正により、当初とその後の使用の両方で、値は整合的に処理されるようになります。