Caché 2016.1

パフォーマンス・モニタの見出しの変更

以前のリリースでは、PERFMON パフォーマンス・モニタで、ビッグ・データの読み取りと書き込みのブロックおよびバッファに関するメトリックのレポートに誤解を招く見出しが存在していました。メトリック 9、16、および 23 の見出しでは、これらのメトリックがルーチンの読み取りと書き込みに関するものであると示されていました。今回のリリースでは、これらの見出しで、これらのメトリックがビッグ・データの読み取りと書き込みに関するものであると正しく示されています。これらのメトリックの見出しは、以下のように変更されています。

• 9 — BdataBlkRd (ビッグ・データ・ブロックの読み取り)

• 16 — BdataBlkWt (ビッグ・データ・ブロックの書き込み)

• 23 — BdataBlkBuf (グローバル・バッファによって満たされたビッグ・データ・ブロック要求)

SSL/TLS 構成の変更

以前のリリースでは、SSL/TLS構成を作成または編集する画面には、[証明書取り消しリストを含むファイル] フィールドが含まれていました。このフィールドは削除されました。

TCP キープアライブ設定とは無関係に接続を維持する ECP アプリケーション・サーバ

以前のリリースでは、ECP アプリケーション・サーバと ECP データ・サーバとの間の接続を ECP で開いた状態にしておく時間は、TCP キープアライブ設定の影響を受けていました。データ・サーバが利用不可になったときに、接続をリダイレクトするまでに費やす時間は、この設定が影響していました。TCP キープアライブは、ECP アプリケーション・サーバと ECP データ・サーバとの間の接続の維持に、まったく影響しなくなりました。例えば、ミラー・プライマリの停止とフェイルオーバーの後に、適切なタイミングでアプリケーション・サーバをリダイレクトできるようにするために、オペレーティング・システム・レベルで TCP キープアライブを調整している場合は、そのような調整の必要がなくなります。

ジャーナル・ファイルの新しい命名方法がディレクトリ名およびスクリプトに影響を及ぼす可能性

今回のリリースでは、1 日にジャーナル処理を行えるデータ量の上限を増やす目的で、ジャーナル・ファイルの命名方法が変更されています。最初の 999 個のジャーナル・ファイルの命名方法は従来と変わりません。それを、次に示します。

YYYYYMMDD.NNN

ここで、YYYYYMMDD は日付、NNN は 001 から 999 までの数値です。以前のリリースでは、Caché で 1,000 個以上のジャーナル・ファイルを作成できませんでした。今回のリリースでは、Caché で 1,000 以上の数に対応するように NNN の桁数が増えています。例えば、2015 年 1 月 1 日に作成された 1 番目、10 番目、100 番目、1,000 番目、および 10,000 番目のジャーナル・ファイルの名前は、それぞれ 20150101.001、20150101.010、20150101.100、20150101.1000、および 20150101.10000 になります。

より長いファイル名に対応するため、Caché では、ディレクトリと接頭語 (存在する場合) の合計の長さが従来の上限よりも 7 文字少ない 208 文字に制限されています。サイトで非常に長いディレクトリや接頭語を使用している場合、より短いものに変更する必要があります。

また、日付の後に 3 桁の数字を付けてジャーナル・ファイルを命名することを想定しているスクリプトが存在する場合、そのスクリプトを修正する必要がある場合があります。例えば、20150101.1000 は 20150101.999 よりも前にソートされるため、ファイル名の数値およびアルファベットのソート順序は日付の順序とは一致しません。

DataCheck ユーティリティの改訂による、最適なスロットル設定の変更

今回のリリースでは、DataCheck ユーティリティが更新されました。その結果、最適なパフォーマンスを実現するために、スロットル設定を変更することができます。設定の移行は円滑に行われます。追加リソースの大量の消費を抑えて、スロットル設定を大きくすると、パフォーマンスの向上につながります。 最適なスロットル設定を決定するには、試してみることが最善の方法です。設定はいつでも調整でき、直ちに有効になります。

Windows

• Windows インストールと CSP ゲートウェイ

  今回のリリースでは、通常インストールと同じ既定値が自動インストールで使用されます。例えば、自動インストールを使用した場合、既定では CSP ゲートウェイはインストールされません。自動インストールで CSP ゲートウェイをインストールするには、コマンド行の ADDLOCAL プロパティで CSP ゲートウェイ・コンポーネントを指定します。すべての機能を含めるには、ADDLOCAL=ALL を指定します。"Caché インストール・ガイド" の “自動インストールの実行” を参照してください。

  Windows インストールにおいて、IIS CSP 構成が存在する場合、CSP.ini はオーバーライドされません。以前のリリースでは、インストールでこのファイルは常にオーバーライドされます。したがって、CSP.ini が誤って構成されている場合、インストールで問題は修正されません。インストールで CSP.ini を確実にオーバーライドするには、Caché をインストールする前に IIS CSP 構成を削除します。

  以前のリリースでは、CSP ゲートウェイのインストール時、システムに Apache が存在する場合、自動的に Apache が構成されていました。今回のリリースでは、CSP ゲートウェイに対して Apache を手動で構成する必要があります。詳細は、"CSP ゲートウェイ構成ガイド" を参照してください。

• Windows Management Instrumentation (WMI) のサポート終了

  今回のリリースでは、Windows Management Instrumentation (WMI) はサポートされません。したがって、iscprov.dll ライブラリはインストールされません。

• インストールからの cdirectmgr ユーティリティの除外

  cdirectmgr ユーティリティの構築およびインストールは行われなくなっています。この Windows ユーティリティは、Windows COM/OLE または C++ クライアント・プログラムからのサーバ操作の直接制御を可能にしていました。これまで cdirectmgr ユーティリティを使用していた場合、キューブを使用して同じ機能を実行する必要があります。

• 異常なシャットダウンに関する改訂された警告メッセージ

  Windows の異常なシャットダウンに続く起動時にコンソール・ログに書き込まれる警告メッセージが改訂されました。その警告メッセージでは、完全な Cache シャットダウンを行わずに Windows がシャットダウンされたときに、緊急 (高速) シャットダウン・プロシージャが実行されたことを報告します。 緊急 (高速) シャットダウン・プロシージャが実行された場合、次回起動時の新しいコンソール・ログ・メッセージは以下のようになります。

  06/18/12-03:30:40:421 (1856) 2 Previous system shutdown was abnormal, system forced down or crashed.Fast shutdown complete.

  緊急 (高速) シャットダウン・プロシージャが実行されなかった場合、次回起動時の通常のコンソール・ログ・メッセージは以下のようになります。

  06/18/12-03:30:40:421 (1856) 2 Previous system shutdown was abnormal, system forced down or crashed.

UNIX®

今回のリリースでは、インストーラは、CSP ゲートウェイのバイナリ更新時に常に Apache を再起動します。以前のリリースでは、インストーラは、Apache を再起動するかをユーザに確認していました。この変更は、インストール・プロセスを自動化し、クエリ・ダイアログを想定するようにコーディングされているスクリプトまたはプログラムにおける互換性の問題にすぎません。

Mac OS X

• インストールにおけるディレクトリの変更

  今回のリリースでは、ccontrol および csession のリンクは、/usr/bin ではなく /usr/local/bin にあります。 /usr/bin のこれらのリンクへの明示的な参照がコードに含まれている場合、新しい場所を反映するようにコードを更新する必要があります。

• OS X 10.11 での Caché eXTreme 機能の使用に関する制限

  Caché eXTreme の 2 つの機能、Java Globals API およびメモリ内 XEP (eXTreme Event Persistence) は、OS X 10.11 では使用できません。Caché eXTreme は、Java を使用して Caché 多次元データ・ストレージに外部アクセスを提供します。 OS X SIP (System Integrity Protection) 機能が無効にされていない限り、OS X 10.11 では Caché eXTreme Java Globals API もメモリ内 XEP も使用できません。

クラス・コンパイラによる長いクラス名の切り捨て処理

スタジオでは長さの上限を超えるクラス名を定義できないようになっていますが、非常に長い名前でコードを生成することは可能です。以前のリリースでは、これにより、クラスのコンパイル時に <NOROUTINE> エラーが発生する場合がありました。今回のリリースでは、クラス名は最大長に切り捨てられます。

クラスの増分コンパイル機能の削除

今回のリリースでは、/incremental コンパイラ・スイッチが削除されています。以前のリリースでは、このスイッチは、変更されたクラス・メソッドのみをコンパイルするよう Caché に指示していました。増分コンパイルによって短縮されるコンパイル時間はわずかであり、実際生成されるコードの効率性も低くなるため、この機能は削除されました。今回のリリースでは、/incremental スイッチを指定しても、コンパイラはそのスイッチを無視します。

コンパイラによる不正なクラス名の不許可

今回のリリースでは、クラス名に “||” (2 つの垂直バー) または “.” (ピリオド) のいずれかが含まれる場合、クラス・コンパイラはエラーを生成します。これらの記号はクラス名に含めることはできず、通常は実行中にエラーを発生させますが、これまではクラス・コンパイラによって許可されていました。

クラスの削除

以前のバージョンに存在していた以下のクラスは、このリリースで削除されています。

• %CSP.UI.Portal.iKnow — Configurations、Dictionary、Settings

• %CSP.UI.Portal.iKnow.Dialog — AddDomainConfig、DeleteDomain、finderDialog

• %DeepSee.DomainExpert — SQLUtils

• %DeepSee.DomainExpert.queries — IK

• %DeepSee.DomainExpert.utils — ConfigurationManager、CubeUtils、EntityUtils、HtmlUtils、IndexBuilder、LinkedLifeData、SentenceParser、SetUtils、UMLSUtils、Utils

• %DeepSee.DomainExpert.utils.classgen — CubeGen

• %DeepSee.DomainExpert.utils.umls — EntityMappingBuilder、EntityTableGenerator、LocalMappingBuilder

• %DeepSee.DomainExpert.wizard.Dialog — newModel

• %DeepSee.DomainExpert.wizards — HeaderKeyExplorer、ITablesLoadingWizard、TransformationEditor

• %JSON — ContentHandler、Parser

• %SYS — TaskSuper

• %SYSTEM.Security — System

• %UMLS — TFIDF

• %UMLS.Install — CBuilder、Scripts

• %UnitTest — DSQL、ESQL、ITablesRegression、JDBCSQL、ODBCSQL、Utility

• %iFind — Comp、CompToWord、Stem、StemToWord

• %iFind.Find — Abstract、Basic、Semantic

• %iFind.Index — AbstractAttribute、AbstractAttributePos、AbstractDominance、AbstractEntBits、AbstractEntSpread、AbstractEntSpreadRec、AbstractEntity、AbstractPath、AbstractPathVal、AbstractProximity、AbstractWordPos

• %iKnow.Objects.dd.ui — HistoryDialog、SearchHistory

• %iKnow.UI — ITablesStatusView、ImportWizard、LoadingWizard、SetAnalysis、SwirlPortal

• %iKnow.ont — Matcher、Matcher2、SQLStoredProc

• SYS.Monitor — SystemSubscriber

削除されたメソッド

以前のバージョンに存在していた以下のメソッドは、今回のリリースで削除されています。

• %CSP.Page

  • HyperEventBody

  • HyperEventFrame

• %CSP.Request

  • Delete

  • DeleteCgiEnv

  • DeleteCookie

  • DeleteMimeData

  • InsertCgiEnv

  • InsertCookie

  • InsertMimeData

  • Set

• %CSP.Stream

  • CharSetGet

  • CharSetSet

  • ContentTypeGet

  • ContentTypeSet

  • ExpiresGet

  • ExpiresSet

  • FileNameGet

  • FileNameSet

  • HeadersGet

  • HeadersSet

  • MimeSectionGet

  • MimeSectionSet

• %CSP.UI.Portal.TaskHistory

  • doDetails

• %CSP.UI.Portal.TaskSchedule

  • ExecuteRS

• %DeepSee.UI.MDXPDF

  • Test

• %iFind.Find.Basic

  • FindResultsLevel

  • FindResultsNodeFindResultsNode

  • FindResultsPattern

  • GetExtent

  • GetWordBitsBeg

  • GetWordBitsFin

  • GetWordBitsMid

  • ParseInput

  • ResolveCompCombArray

  • ResolveCompWords

  • ResolveCompoundToWords

  • ResolveCompoundToWordsAND

  • ResolveStemToWords

  • ResolveStemmedCombArray

  • ResolveStemmedWords

  • SearchBeg

  • SearchFin

  • SearchMid

  • SearchPos

  • SearchPosD

  • SearchPosInternal

  • SearchPosS

  • SearchWrd

  • SearchWrdD

  • SearchWrdS

  • WordBitsToRecIds

  • WordToRecIds

• %iFind.Find.Semantic

  • BuildRecordIds

  • BuildRecordIdsAnd

  • CheckEntBeg

  • CheckEntFin

  • CheckEntGrp

  • CheckEntGrpD

  • CheckEntGrpEnt

  • CheckEntGrpEntD

  • CheckEntGrpEntS

  • CheckEntGrpS

  • CheckEntMid

  • CheckEntWrd

  • CheckEntWrdD

  • CheckEntWrdS

  • CheckGrp

  • CheckGrpD

  • CheckGrpEnt

  • CheckGrpEntD

  • CheckGrpEntS

  • CheckGrpS

  • FindResultsLevel

  • GetEntsByWordPos

  • ParseInput

• %iFind.Index.Basic

  • GetIndexParams

• %iKnow.UI.IndexingResults

  • UpdateSentences

  • updateSentencesClient

削除されたプロパティ

以前のバージョンに存在していた以下のプロパティは、今回のリリースで削除されています。

• %CSP.UI.Portal.Locks

  • isVMS

• %CSP.UI.Portal.LocksView

  • isVMS

• %Exception.CPPException

  • iStack

• %iKnow.UI.IndexingResults

  • sentFrom

  • sentTo

削除されたパラメータ

以前のバージョンに存在していた以下のパラメータは、このリリースで削除されています。

• %Library.CacheLiteral

  • SELECTIVITY

• %SQL.Manager.ShowPlan

  • RESOURCE

• %UnitTest.SQLRegression

  • CORRELATIONLIST

  • DATACLASS

  • DATAFILE

  • DATATAG

また、プロパティ・パラメータ SELECTIVITY は非推奨になり、スタジオやドキュメントに表示されなくなりました。このパラメータが存在する場合、その効果は以前のリリースと同じになります。このプロパティ・パラメータは、既存のコードから削除することをお勧めします。

削除されたインデックス

以前のバージョンに存在していた以下のインデックスは、このリリースで削除されています。

• %iFind.Comp

  • ValueIdx

• %iFind.Stem

  • ValueIdx

変更されたメソッド

今回のバージョンの Caché では、以下のメソッドのシグニチャが変更されました。

• %CSP.UI.Portal.Mirror.Monitor

  • 古いメソッド ： DrawFailoverInfo () As %Status

  • 新しいメソッド ： DrawFailoverInfo (RefreshCompress) As %Status

  • 古いメソッド ： updateView () As (none)

  • 新しいメソッド ： updateView (InTimer, NoCompress) As (none)

• %CSP.UI.Portal.Namespaces

  • 古いメソッド ： filterChanged (value) As (none)

  • 新しいメソッド ： filterChanged (value, tableID) As (none)

• %CSP.UI.Portal.TaskSchedule

  • 古いメソッド ： filterChanged (value) As (none)

  • 新しいメソッド ： filterChanged (value, tableID) As (none)

• %Debugger.System

  • 古いメソッド ： DebugStub () As (none)

  • 新しいメソッド ： DebugStub (pWriteOutput) As (none)

• %DeepSee.Component.Widget.pivot

  • 古いメソッド ： exportPDF () As (none)

  • 新しいメソッド ： exportPDF (printMultiple, preserveTempFiles) As (none)

• %DeepSee.ResultSet

  • 古いメソッド ： %GetFiltersForCellRange (*pFilters:%String, pStartRow:%Integer, pStartCol:%Integer, pEndRow:%Integer, pEndCol:%Integer, *pMeasure:%String, pAllRows:%Boolean=0, pAllCols:%Boolean=0, pSortCol:%Integer=0, pSortDir:%String="ASC") As %Status

  • 新しいメソッド ： %GetFiltersForCellRange (*pFilters:%String, pStartRow:%Integer, pStartCol:%Integer, pEndRow:%Integer, pEndCol:%Integer, *pMeasure:%String, pAllRows:%Boolean=0, pAllCols:%Boolean=0, pSortCol:%Integer=0, pSortDir:%String="ASC", &pPluginInfo:%String) As %Status

• %DeepSee.UI.Analyzer

  • 古いメソッド ： adjustSizes () As (none)

  • 新しいメソッド ： adjustSizes (load) As (none)

• %DeepSee.UserPortal.DashboardViewer

  • 古いメソッド ： ClearDashboardAutosaveState (pAutosaveItems:%ZEN.proxyObject) As %Status

  • 新しいメソッド ： ClearDashboardAutosaveState (pAutosaveItems:%ZEN.proxyObject, pDashboardName:%String, pAutosave:%String) As %Status

• %DeepSee.Utils

  • 古いメソッド ： %CompressIndices (pCubeName:%String, pVerbose:%Boolean=0) As (none)

  • 新しいメソッド ： %CompressIndices (pCubeName:%String, pVerbose:%Boolean=0) As %Status

• %Library.Persistent

  • 古いメソッド ： %BuildIndices (pIndexList:%CacheString="", pAutoPurge:%Integer=0, pLockFlag:%Integer=0, pJournalFlag:%Integer=0, pStartID:%CacheString="", pEndID:%CacheString="") As %Status

  • 新しいメソッド ： %BuildIndices (pIndexList:%CacheString="", pAutoPurge:%Integer=1, pLockFlag:%Integer=0, pJournalFlag:%Integer=1, pStartID:%CacheString="", pEndID:%CacheString="") As %Status

  • 古いメソッド ： %DeleteExtent (concurrency:%Integer=-1, &deletecount, &instancecount, pInitializeExtent:%Integer=1) As %Status

  • 新しいメソッド ： %DeleteExtent (concurrency:%Integer=-1, &deletecount, &instancecount, pInitializeExtent:%Integer=1, *errorLog:%Status) As %Status

• %Library.RoutineMgr

  • 古いメソッド ： TS (name:%String, &compiletime:%TimeStamp) As %TimeStamp

  • 新しいメソッド ： TS (name:%String, *compiletime:%TimeStamp, *uptodate:%Boolean) As %TimeStamp

  • 古いメソッド ： GetCurrentTimeStamp (&compiletime:%TimeStamp) As %TimeStamp

  • 新しいメソッド ： GetCurrentTimeStamp (&compiletime:%TimeStamp, &uptodate:%Boolean) As %TimeStamp

• %SYSTEM.DeepSee

  • 古いメソッド ： SynchronizeCube (pCubeName:%String, pVerbose:%Boolean=0) As %Status

  • 新しいメソッド ： SynchronizeCube (pCubeName:%String, pVerbose:%Boolean=0, *pFactsUpdated:%Integer, pReadCommitted:%Boolean=1, pCheckReferences:%Boolean=1, pAsync:%Boolean=0) As %Status

• %SYSTEM.OBJ

  • 古いメソッド ： CompileList (&list:%String="", qspec:%String="", &errorlog:%String) As %Status

  • 新しいメソッド ： CompileList (&list:%String="", qspec:%String="", &errorlog:%String, &updatedlist:%String) As %Status

• %SYSTEM.iKnow

  • 古いメソッド ： GetDomainId (pDomainName:%String) As %Integer

  • 新しいメソッド ： GetDomainId (pDomainName:%String="") As %Integer

• %Stream.Object

  • 古いメソッド ： FindAt (position:%Integer, target:%CacheString, &tmpstr:%CacheString, caseinsensitive:%Boolean=0) As %Integer

  • 新しいメソッド ： FindAt (position:%Integer, target:%CacheString, &tmpstr:%CacheString="", caseinsensitive:%Boolean=0) As %Integer

• %Studio.Project

  • 古いメソッド ： realCompile (qstruct, &%errorlog:%String, &itemlist:%String) As %Status

  • 新しいメソッド ： realCompile (qstruct, &%errorlog:%String, &itemlist:%String, &updatedlist:%String) As %Status

• %XML.Node

  • 古いメソッド ： FirstAttributeName () As (none)

  • 新しいメソッド ： FirstAttributeName () As %String

  • 古いメソッド ： LastAttributeName () As (none)

  • 新しいメソッド ： LastAttributeName () As %String

  • 古いメソッド ： NextAttributeName (attributeName:%String) As (none)

  • 新しいメソッド ： NextAttributeName (attributeName:%String) As %String

  • 古いメソッド ： PreviousAttributeName (attributeName:%String) As (none)

  • 新しいメソッド ： PreviousAttributeName (attributeName:%String) As %String

• %XML.Writer

  • 古いメソッド ： Document (document:%XML.Document) As %Status

  • 新しいメソッド ： Document (documentArg:%XML.Document) As %Status

  • 古いメソッド ： Object (object:%XML.Adaptor, tag:%String, namespace:%String, local:%Boolean, className:%String, bare:%Boolean) As %Status

  • 新しいメソッド ： Object (objectArg:%XML.Adaptor, tag:%String, namespace:%String, local:%Boolean, className:%String, bare:%Boolean) As %Status

• %ZEN.Mojo.Wizard.MojoWizard

  • 古いメソッド ： CreateZenMojoTemplate (tempName:%String, pkgName:%String, application:%String, domain:%String, pPageManager:%String) As %Status

  • 新しいメソッド ： CreateZenMojoTemplate (tempName:%String, pkgName:%String, application:%String, domain:%String, pageName:%String, pPageManager:%String) As %Status

• %ZEN.Report.Display.report

  • 古いメソッド ： %DrawToHTML (&context:%String, &XSL:%GlobalCharacterStream, delay:%GlobalCharacterStream, &incell:%Boolean, embedXSL:%Boolean=0, UseInternalXSLT:%Boolean=0, SubReport:%String, MainReport:%String) As %Status

  • 新しいメソッド ： %DrawToHTML (&context:%String, &XSL:%GlobalCharacterStream, delay:%GlobalCharacterStream, &incell:%Boolean, embedXSL:%Boolean=0, UseInternalXSLT:%Boolean=0, SubReport:%String, MainReport:%String, pXSLTMode) As %Status

• %iFind.Utils

  • 古いメソッド ： TestSearchString (pSearchString:%String, *pNormalizedString:%String) As %Status

  • 新しいメソッド ： TestSearchString (pSearchString:%String, *pNormalizedString:%String, *pDidYouMean:%String) As %Status

• %iKnow.Tables.Utils

  • 古いメソッド ： SyncCustomizations (pDomainId:%Integer="", pPackageName:%String="", pAutoPurge:%Boolean=0, pStartSrcId:%Integer="", pEndSrcId:%Integer="", &pRanges) As %Status

  • 新しいメソッド ： SyncCustomizations (pDomainId:%Integer="", pPackageName:%String="", pAutoPurge:%Boolean=1, pStartSrcId:%Integer="", pEndSrcId:%Integer="", &pRanges) As %Status

  • 古いメソッド ： SyncDictionaryMatchCustomizations (pDomainId:%Integer="", pPackageName:%String="", pAutoPurge:%Boolean=0, pStartSrcId:%Integer="", pEndSrcId:%Integer="", pFilter:%iKnow.Filters.Filter="") As %Status

  • 新しいメソッド ： SyncDictionaryMatchCustomizations (pDomainId:%Integer="", pPackageName:%String="", pAutoPurge:%Boolean=1, pStartSrcId:%Integer="", pEndSrcId:%Integer="", pFilter:%iKnow.Filters.Filter="") As %Status

• Ens.MessageHeader

  • 古いメソッド ： NewRequestMessage (&pHeader:Ens.MessageHeader, pMessageBody:%Library.Persistent, &pSessionId:%String) As %Status

  • 新しいメソッド ： NewRequestMessage (&pHeader:Ens.MessageHeader, pMessageBody:%Library.Persistent, &pSessionId:%String, &pSuperSession:%String) As %Status

• Ens.VDoc.SearchTable

  • 古いメソッド ： genGetCodeList (tGetExpression:%String) As %String

  • 新しいメソッド ： genGetCodeList (tGetExpression:%String, tPreExpression:%String, tPostExpression:%String) As %String

• Ens.VDoc.XMLSearchTable

  • 古いメソッド ： genGetCodeList (tGetExpression:%String) As %String

  • 新しいメソッド ： genGetCodeList (tGetExpression:%String, tPreExpr:%String, tPostExpr:%String) As %String

INSERT、UPDATE、および DELETE クエリで使用できない UNION の %PARALLEL

以前のリリースでは、非 UNION の INSERT、UPDATE、および DELETE クエリでは %PARALLEL を使用できませんでしたが、UNION の INSERT、UPDATE、または DELETE クエリで %PARALLEL を使用した場合はエラーになりませんでした。これらのクエリでは %PARALLEL が確実には機能していませんでした。今回のリリースでは、UNION と非 UNION の両方の INSERT、UPDATE、および DELETE クエリで %PARALLEL を使用できなくなっています。以前のリリースでこの構文を使用した場合、エラー・メッセージは出ませんでしたが、高い確率で問題が発生していました。INSERT、UPDATE、または DELETE クエリに存在する %PARALLEL オプションは、すべて削除する必要があります。

Floor 関数の修正による返り値の変更

以前のバージョンでは、返り値の型が、整数値を持つ $list 型 6 およびゼロのスケールを持つ SQLType Numeric (2) である場合、ODBC Floor() 関数は値を正しく切り捨てていませんでした。例えば、関数が、末尾に誤った小数点の付いた “1234.” を返す場合がありました。今回のリリースでは、Floor() 関数が数値を正しく切り捨て、小数点のない “1234” を返すようになっています。この誤った結果を想定し、これを補正するアプリケーションのコーディングを行っている場合は、その修正コードを削除する必要があります。このエラーは、SQLType Numeric (2) およびゼロのスケールでのみ発生します。その他の型やゼロ以外のスケールでは発生しません。

照合式のエラーの検査

今回のリリースでは、Caché は照合式を調べて、エラーを確認します。前のリリースでは、Caché はこれらのエラーを無視していました。多くの場合、照合式のエラーは SQL の使用時にエラーを生じていました。しかし、照合式エラーの中には、SQL エラーを生じなかったものもある可能性があります。その場合、前のリリースで正常に実行されているように思えたコードに、今回のリリースではエラーが発生します。

長さゼロの文字列を正しく処理する集約関数

長さゼロの文字列を正しく処理する集約関数 - 今回のリリースでは、XMLAGG() および LIST() 集約関数は長さ 0 の文字列を正しく処理します。前のリリースでの長さ 0 の文字列の不適切な処理方法に依存するコードがある場合は、修正する必要があります。

先行読み取りをサポートするために JDBC データ・モデルに行われた重要な内部変更

このリリースには、SQL JDBC データ・モデルに対するパフォーマンスの向上が多数含まれています。これらの変更により何らかの非互換性が生じるかどうかは不明ですが、実装の詳細の変更が特殊な状況での動作に影響を与える可能性は考えられます。そのため、この機能を実行するコードをテストすることをお勧めします。

XML および ODBC の時刻を変換する関数のロケールの変更

以前のリリースでは、XML および ODBC の時刻形式を変換する %Library.TimeOpens in a new tab メソッドは現在のロケールを使用していました。これにより、小数点区切り文字が "." (ピリオド文字) でないロケールにおいて問題が生じていました。XML および ODBC では、常にこの区切り文字にピリオド文字が使用されるためです。今回のリリースでは、これらの関数が常に小数点区切り文字にピリオドを使用するようになっています。XML または ODBC メッセージの設定または評価を行う目的でこれらのメソッドを呼び出す場合は問題ありません。しかし、コードでこれらのメソッドを他のコンテキストにおいて使用し、現在のロケールの小数点区切り文字を想定している場合、コードを修正する必要があります。変更された %Library.TimeOpens in a new tab メソッドは、LogicalToXSD(),、XSDToLogical()、LogicalToOdbc()、および OdbcToLogical() です。

以前のリリースでは、%Library.TimeOpens in a new tab メソッドの小数秒の切り捨てに一貫性がありませんでした。今回のリリースでは、既定でこれらのメソッドは常に小数秒を保持します。また、保持する小数点以下の桁数を制御する新しい PRECISION パラメータが用意されています。PRECISION が 0 の場合、時刻値は最も近い秒数に丸められます。

ソフトウェア・ライセンスが必要となる iFind インデックスのコンパイル

iFind を使用する場合、常に有効な iKnow ライセンスが必要でした。今回のリリース以降、iFind インデックスを持つクラスのコンパイル時、インスタンスの iKnow 有効化ライセンスが存在するかどうかを Caché で確認するようになります。iKnow を使用するための適切なライセンスが付与されていない場合はエラーがスローされます。iFind インデックスを持つクラスのリコンパイルはさらなる最適化を実現するため通常は推奨されますが、2015.3 へのアップグレード後は必須ではありません。

リコンパイルおよび再構築が必要となる特定の iFind インデックス

語幹解析または複合語分解を使用する iFind インデックス (INDEXOPTION != 0) には、変更されたコンパイル済みのフォームが含まれています。したがって、今回のリリースへのアップグレード後、語幹解析または複合語分解を使用する既存のインデックスをすべてリコンパイルし、再構築する必要があります。

語幹および複合語について特定のマッピングを使用する代わりに、新しい %iFind.OriginalWord および %iFind.WordTransformation テーブルを使用することをお勧めします。特定のマッピングを使用するとサポートされる機能は保持されますが、これらの新しいテーブルの使用をお勧めします。

JSON からオブジェクトへの変換のエラー処理の変更

以前のリリースでは、$fromJSON() 関数は通知なしで失敗し、有効なオブジェクトを返しませんでした。今回のリリースでは、この関数は、エラーの状況になるとエラーを返します。TRY-CATCH ブロックに $fromJSON() の呼び出しを含めることで、このエラーがアプリケーションを妨げないようにする必要があります。

例えば、$fromJSON() 関数が有効なオブジェクトを返したことを確認する以下のコードが存在する場合、

  set obj = ##class(%AbstractObject).$fromJSON(source [,.stats]) 
  if ('$isobject(obj)) { 
    w "Compilation error occurred",! q 
  } 

次のような TRY-CATCH ブロックに置換する必要があります。

  try { 
    set obj = ##class(%AbstractObject).$fromJSON("[1,2,WE WILL FAIL HERE") 
  } catch ex { 
    w "JSON Parsing error",! 
    w "Name = "_ex.Name,! 
    w "Code = "_ex.Code,! 
    w "Location = "_ex.Location,! 
  } 

SMTP パスワード入力における動作の変更

以前のリリースでは、Caché による SMTP パスワードのクエリは 1 回しか行われませんでした。今回のリリースでは、Caché によるパスワードのクエリは 2 回行われ、各プロンプトに同一のパスワードが入力されていることが確認されます。この変更により、Caché がパスワードに NULL 文字列を使用しようとする状況が発生しなくなっています。

パスワード・プロンプトに応答するスクリプトを作成している場合、2 回目のパスワード要求に対応するようにスクリプトを修正する必要があります。

暗号化されずに提供される MDX コンテキスト

一部のロケールにおける問題を修正するために、今回のリリースでは、MDX コンテキストが維持されず、暗号化されません。%OnDashboardAction で MDX コンテキスト (pContext.mdx) を参照するカスタム・アクション・コードを使用している場合、コードを修正してリコンパイルする必要があります。例えば、MDX コンテキストを復号化する以下のコードが存在する場合、

Set tMDX = $$$cspDecode(%session.Key,pContext.mdx) 

復号化することなく MDX コンテキストを直接参照する以下のコードに置換する必要があります。

Set tMDX = pContext.mdx

この変更を行わないと、cspDecode の呼び出しでエラーが発生します。

数値名の付いたメンバに対する新しいオプション

ソース式に基づいたレベルがキューブに含まれていて、そのレベルに数値名の付いたメンバがあると、極めて特殊なシナリオで、誤った結果を受け取ることがあります。

問題になるシナリオでは、クエリで MDX 範囲式 (例えば、([UnitsPerTransaction].[H1].[UnitsSold].&[7]:&[10])など) を使用していて、さらに、エンド・ポイント・メンバの 1 つが存在していません。このようなシナリオの場合、DeepSee は異なるエンド・ポイント・メンバを選択しようとします。レベルがソース式に基づいている場合、DeepSee は正しく置換メンバを選択するために必要な情報を得られないため、誤ったメンバを選択してしまうことがあります。このシナリオでは、数値として扱う必要のあるメンバを DeepSee に指示するために、追加情報を指定する必要があります。

すべてのキューブのレベル定義を確認して、以下のようにすることをお勧めします。

1. レベルがソース・プロパティに基づいている場合、変更は不要です。

2. レベルでメンバに純粋な数値名が付いている場合、スタジオでキューブを修正して、レベル定義に castAsNumeric="true" を追加します。

   このオプションは、[ソート] オプションとは異なります。[ソート] オプションは、DeepSee が新しいエンド・ポイント・メンバを検索する方法に影響を与えません。

3. キューブ・クラスをリコンパイルします。

   キューブを再構築する必要はありません。

4. 以前に問題のあるシナリオが発生していて、問題のあるクエリに関する結果がキャッシュされている場合は、その結果キャッシュをリセットします。

   結果キャッシュをクリアするには、%DeepSee.UtilsOpens in a new tab の %Reset() メソッドを使用します。このメソッドは、すべてのユーザに対して直ちに影響を及ぼすことにも注意してください。一般に、このメソッドは開発時にのみ使用することを目的としています。また、現在のネームスペースにのみ影響することに注意してください。

暗号化されなくなった pContext.mdx

以前のリリースでは、%OnDashboardAction() メソッド内で、基礎になる MDX クエリは暗号化された形式で指定されていました。特に、データ・ソースがピボット・テーブルの場合には、MDX クエリが pContext.mdx に含まれています。以前のリリースでは、クエリを復号化するために、以下のようなコードを使用する必要がありました。

 set myvariable = $$$cspDecode(%session.Key,pContext.mdx)

これからは、以下のようなコードを代用できます。

 set myvariable = pContext.mdx

クロス結合が存在するピボット・テーブルに基づくスコアカードを修正する必要がある可能性

今回のリリースでは、クロス結合が存在するピボット・テーブルに基づくスコアカード・ウィジェットにおける問題が修正されています。以下の条件をすべて満たすスコアカード・ウィジェットが存在する場合、ウィジェットを編集して、スコアカードのプロパティを再選択する必要があります。その条件は以下のとおりです。

• スコアカード・ウィジェットである。

• スコアカードのデータ・ソースがピボット・テーブルである。

• ピボット・テーブルの列には 1 つのレベル、行には 1 つのメジャーが含まれている。

これらの条件がすべて当てはまる場合にのみスコアカードを編集する必要があります。複数のメジャーが存在するスコアカードや KPI に基づくスコアカードを編集する必要はありません。

メジャーが 1 つしか存在しないピボット・テーブルのラベル

以前のリリースでは、メジャーが 1 つしか存在しない場合、ピボット・テーブルのメジャーのヘッダの表示方法に一貫性がありませんでした。単一の計算済みメジャーについては常にメジャーのヘッダが表示されていましたが、単一の未計算メジャーについてはメジャーのヘッダが表示されていませんでした。 現在は、ピボット・テーブルのメジャーのヘッダの表示方法は一貫しています。 既定では、複数の (計算済みまたは未計算) メジャーが存在する場合にメジャーのヘッダが表示されます。これは、[メジャー] オプションを使用して変更できます。

計算済みメジャーが 1 つしか存在しないピボット・テーブルがあり、これについてもメジャーのヘッダを表示したい場合、[メジャー] オプションを使用して、[メジャーのヘッダの表示] を [常に] に変更します。

長いラベルおよびタイトルの処理の改善により出力が変わる可能性

今回のリリースでは、Zen による長いラベルおよびタイトルの処理方法が改善されており、これらの間で重なり合うことがなくなっています。ラベルが占めるスペースがグラフ自体よりも大きい場合、Zen では y 軸のタイトルのみを使用してグラフが表示され、ラベルは非表示になります。このラベルおよびタイトルの処理の改善により、グラフの表示のされ方が変わる場合があります。

レポートには Body 要素が必要になる

今回のリリースでは、Zen レポート・コンパイラは、レポートに body 要素が含まれていることを求めます。この点で、多くの場合、エラーは修正を必要とするレポートを指すため、役立ちます。まれに、有効なレポートが body 要素を必要としないことがあります。このようなレポートは正常にコンパイルされません。したがって、これらのレポートに body 要素を追加する必要があります。

変更を必要とする TZ を設定するカスタム・コールアウト・ライブラリ関数

時間関数を再入可能にし、セキュリティで保護するために、特定の環境では、TZ 環境変数を設定するコードを変更する必要があります。 Linux または Windows で実行している場合、カスタム・コールアウト・ライブラリ関数で TZ 環境変数を設定した後で、tzset() への呼び出しを追加する必要があります。tzset() への呼び出しにより、内部変数 tzname、timezone、および daylight の更新が行われます。

コードがログ形式に依存する場合、整合性チェックからの出力の変更により、問題が生じる可能性がある

整合性チェックの改善により、ログ出力に変更が生じました。ログ・メッセージの正確なテキストに依存するコードがある場合、改訂する必要があります。

Lock コマンドは Unlock ("D" モード) の変更を延期する

前のリリースでは、"D" モードのアンロックの動作は、同じロック・ノードに入れ子になったロックがある場合に適切に定義されていませんでした。 この問題が改善され、前のアンロックが "D" モードでアンロックされている「外側の」ロックの内部に入れ子になっていたとしても、"D" モードのアンロックは前のアンロックの状態を考慮します。

新しい $$$AssertFailure マクロ

今回のリリースでは、新しい $$$AssertFailure マクロは、無条件にテストに失敗し、指定されたメッセージを記録します。/debug 修飾子が指定されている場合、その時点においてデバッガでテストが中断します。他のアサーションの規則に従い、失敗を示す 0 が返されます。 このマクロは、テストにおいて例外が想定されている後、TRY ブロックなどで偽をアサートする規則を置き換えることを目的としています。

これは、UnitTest クラスのサブクラスを作成しており、新しいマクロがベース・クラスに対する拡張と競合する場合の互換性の問題にすぎません。