#Caché

0 关注者 · 975 帖子

  

InterSystems Caché 是一个多模型 DBMS 和应用服务器。

查看此处提供的更多详细信息

文档

文章 姚 鑫 · 八月 24, 2021 2m read

第141章 触发器关键字 - UpdateColumnList

指定一个或多个列,其修改将导致SQL触发触发器。 仅对TSQL可用。

用法

要指定其修改触发触发器的列,请使用以下语法:

Trigger name [ Event = sqlevent, UpdateColumnList = updatecolumnlist ]  {    //implementation }

其中updatecolumnlist是一个列名或用逗号分隔的列名列表,用括号括起来。

详情

该关键字指定一个或多个列,其修改将触发触发器。 注意,此关键字仅对TSQL可用。

第142章 XData关键字 - Internal

指定这个XData块是否是内部的(不在类文档中显示)。 注意,类文档目前根本没有显示XData

用法

要指定这个XData块是内部的,请使用以下语法:

XData name [ Internal ]  { }

否则,忽略该关键字或将Not放在该关键字之前。

详情

类文档中不显示内部类成员。 如果希望用户看到一个类而不是它的所有成员,则此关键字非常有用。

注意,类文档目前根本没有显示XData块。

第143章 XData关键字 - MimeType

指定XData块的MIME类型。

用法

要指定XData块的MIME类型,请使用如下语法:

XData name [ MimeType = mimetype ] { }
0
0 113
文章 姚 鑫 · 八月 23, 2021 2m read

第137章 触发器关键字 - OldTable

指定存储受事件影响的行或语句的旧值的转换表的名称。

用法

要指定存储旧值的转换表的名称,请使用以下语法:

Trigger name [ Event = sqlevent, OldTable = oldtable, NewTable = newtable ] {    //implementation }

其中oldtable是此命名空间中的SQL表的名称。

详情

每个触发器都可以通过转换表(由旧表和新表关键字指定)访问受事件影响的行或语句的旧值和新值。

默认

默认值为空字符串。

第138章 触发器关键字 - Order

在同一个EVENTTIME有多个触发器的情况下,指定触发器应该触发的顺序。

用法

要指定此触发器的触发顺序,相对于具有相同EVENTTIME的其他触发器,请使用以下语法:

Trigger name [ Event = sqlevent, Order = n, Time = time ] {    //implementation }

其中n为整数。

详情

在同一个EVENTTIME有多个触发器的情况下,该关键字指定触发器应该触发的顺序。

默认

默认值为0

第139章 触发器关键字 - SqlName

指定用于此触发器的SQL名称。

用法

要覆盖此触发器的默认SQL名称,请使用以下语法:

0
0 100
文章 姚 鑫 · 八月 22, 2021 3m read

第133章 触发器关键字 - Foreach

控制触发器何时被触发。

用法

Trigger name [ Event = sqlevent, Foreach = foreach ]  {    //implementation }

其中foreach是下列值之一:

  • row — 该触发器由触发语句影响的每一行触发。 注意,TSQL不支持行级触发器,因此Language关键字的设置必须是objectscript
  • row/object — 此触发器由受触发语句或通过对象访问进行的更改影响的每一行触发。请注意,TSQL不支持行级触发器,因此Language关键字的设置必须为objectscript

这个选项定义了一个统一触发器,之所以这么叫,是因为它是由通过SQL或对象访问发生的数据更改触发的。 (相比之下,与其他触发器相比,如果在通过对象访问发生更改时使用相同的逻辑,则需要实现回调,如%OnDelete()。)

  • statement — 整个语句只触发一次触发器。 ObjectScriptTSQL都支持语句级触发器; 即Language关键字的设置分别为objectscripttsql

详情

控制何时触发触发器。

默认

如果省略此关键字,则触发器为行级触发器。

例外

TSQL不支持行级触发器。

第134章 触发器关键字 - Internal

指定此触发器定义是否为内部触发器(不显示在类文档中)。

用法

0
0 149
文章 姚 鑫 · 八月 21, 2021 3m read

第129章 查询关键字 - WebMethod

指定这个类查询是否为web方法。 仅应用于定义为web服务web客户端的类。

用法

要指定这个查询是一个web方法,请使用以下语法:

Query name(formal_spec) As classname [ WebMethod ] {    //implementation }

否则,忽略该关键字或将Not放在该关键字之前。

详情

这个关键字指定这个类查询是否是一个web方法,是否可以通过SOAP协议调用。

默认

如果忽略此关键字,则无法以web方法调用查询。

生成的类

当你将这个关键字添加到类查询并编译类时,类编译器会生成两个额外的类:

  • Package.OriginalClass.QueryName
  • Package.OriginalClass.QueryName.DS

Package.OriginalClass是包含web方法的类,QueryName是类查询的名称。

例如,假设从类ROBJDemo.QueryWS开始。 ,然后向它添加一个名为MyQuery的类查询。 当你将WebMethod关键字添加到该类查询并编译它时,类编译器会生成以下额外的类:

  • ROBJDemo.QueryWS.MyQuery
  • ROBJDemo.QueryWS.MyQuery.DS

不要修改或直接使用这些生成的类;它们仅供内部使用。

WSDL的关系

0
0 122
文章 姚 鑫 · 八月 20, 2021 2m read

第125章 查询关键字 - SqlName

覆盖投影SQL存储过程的默认名称。 仅当此查询被投影为SQL存储过程时应用。

用法

要覆盖查询投射为SQL存储过程时使用的默认名称,请使用以下语法:

Query name(formal_spec) As classname [ SqlProc, SqlName = sqlname ] {    //implementation }

其中sqlnameSQL标识符。

详解

如果将此查询投影为一个SQL存储过程,则使用此名称作为存储过程的名称。

默认

如果忽略此关键字,查询名称将用作SQL过程名称。

第126章 查询关键字 - SqlProc

指定查询是否可以作为SQL存储过程调用。

用法

要指定查询可以作为SQL存储过程调用,请使用以下语法:

Query name(formal_spec) As classname [ SqlProc ] {    //implementation }

否则,忽略该关键字或将Not放在该关键字之前。

详情

该关键字指定是否可以作为SQL存储过程调用查询。

默认

如果忽略此关键字,则无法将查询作为SQL存储过程调用。

第127章 查询关键字 - SqlView

指定是否将此查询投影为SQL视图。

用法

要指定查询投影为SQL视图,请使用以下语法:

0
0 151
问题 Michael Lei · 八月 19, 2021

我有一个CSP页面,当我把大量的文本(例如:10000个字符)放到一个提交的表单的一个字段中时,会出现 "414 error - Request-URI Too Long"。该表格是用POST方法提交的。

根据我做的一些实验,似乎一个URL的最大尺寸是8200个字符左右。

官方的限制是什么,是否有办法增加它?我在文档中搜索了一下,但没有找到任何东西。

1
0 206
文章 姚 鑫 · 八月 19, 2021 4m read

第121章 查询关键字 - Private

指定查询是否为私有查询。

用法

要指定此查询为私有查询,请使用以下语法:

Query name(formal_spec) As classname [ Private ] {    //implementation }

否则,请省略此关键字或将该词放在该关键字之前。

详解

私有类成员只能由同一类(或其子类)的其他成员使用。请注意,其他语言通常使用单词Protected来描述这种可见性,使用单词Private来表示从子类不可见。

默认

如果省略此关键字,则此查询不是私有的。

第122章 查询关键字 - SoapBindingStyle

指定此查询用作Web方法时使用的绑定样式或SOAP调用机制。仅适用于定义为Web服务Web客户端的类。

用法

要覆盖查询使用的默认绑定样式(当它用作Web方法时),请使用以下语法:

Query name(formal_spec) As classname [ WebMethod, SoapBindingStyle = soapbindingstyle ] {    //implementation }

其中soapbindingstyle为下列值之一:

  • document - 此Web方法使用文档式调用。

使用这种绑定样式,SOAP消息被格式化为文档,并且通常只有一个部分。

0
0 103
文章 姚 鑫 · 八月 18, 2021 2m read

第117章 属性关键字 - Transient

指定属性是否存储在数据库中。仅适用于持久类。

用法

要指定属性不存储在数据库中,请使用以下语法:

Property name As classname [ Transient ];

否则,请省略此关键字或将该词放在该关键字之前。

详情

对于持久化类,指定属性不存储在数据库中。

请注意, IRIS验证瞬态属性的方式与验证其他属性的方式相同。例如,当保存对象时,系统会验证其所有属性,包括所有临时属性。

在子类中,可以将非瞬态属性标记为瞬态Transient,但不能反过来。

默认

如果省略此关键字,则属性不是瞬态Transient的。

第118章 查询关键字 - ClientName

此查询的客户端投影使用的别名。

用法

要在将查询投影到客户端语言时覆盖查询的默认名称,请使用以下语法:

Query name(formal_spec) As classname [ ClientName = clientname ] {    //implementation }

其中clientname是在客户端语言中使用的名称。

详情

当查询被投影到客户端语言时,此关键字允许定义查询的替代名称。如果查询名称包含客户端语言中不允许的字符,这尤其有用。

默认

如果省略此关键字,查询名称将用作客户端名称。

第119章 查询关键字 - Final

指定此查询是否为最终查询(不能在子类中覆盖)。

用法

0
0 123
文章 姚 鑫 · 八月 17, 2021 4m read

第113章 属性关键字 - SqlComputeOnChange

此关键字控制何时重新计算属性。仅适用于触发的计算属性。

用法

要指定何时重新计算属性,请使用以下语法:

Property name As classname [ SqlComputed, SqlComputeCode=sqlcomputecode, SqlComputeOnChange = propertynames ];

其中sqlcomputecodeSqlComputeCode中描述,propertyname是单个属性名或以逗号分隔的属性名列表。该值还可以包括值%%INSERT%%UPDATE

请注意,必须使用实际的属性名,而不是SqlFieldname给出的值。

详解

此关键字仅适用于触发的计算属性;对于其他属性,它将被忽略。(触发的计算属性是一个属性,其SqlComputed为真,并且指定了SqlComputeCode,但是其computedTransient都为假)

此关键字控制重新计算此属性的条件。重新计算可能源于:

  • 对任何指定属性的修改。
  • 触发器事件的发生。

如果关键字的值为%%INSERT%%UPDATE,则分别调用INSERTUPDATE,指定字段(属性)值的事件触发计算。

0
0 133
文章 姚 鑫 · 八月 16, 2021 4m read

第109章 属性关键字 - ServerOnly

指定是否将此属性投影到Java客户机。

用法

要指定属性是否被投影到Java客户端,请使用以下语法:

Property name As classname [ ServerOnly = n ];

其中n是下列之一:

  • 0表示此属性是投影的。
  • 1表示不投影该属性。

详解

此关键字指定属性是否被投影到Java客户端。

默认

如果省略此关键字,属性将被投影。

第110章 属性关键字 - SqlColumnNumber

指定此属性的SQL列号。仅适用于持久类。

用法

要指定属性的SQL列号,请使用以下语法:

Property name As classname [ SqlColumnNumber = 4 ]; 

其中n是正整数。

详解

此关键字允许显式设置此属性的SQL列号。这是为了支持传统应用程序而提供的。

默认

默认值为空字符串。

第111章 属性关键字 - SqlComputeCode

指定设置此属性值的代码。

用法

要指定属性的计算方式,请使用以下语法:

Property name As classname [ SqlComputeCode = { Set {FieldName} = Expression }, SqlComputed ];
  • FieldName—正在定义的属性的SQL字段名称。
  • Expression—对象指定属性值的脚本表达式。

详解

0
0 128
文章 姚 鑫 · 八月 15, 2021 4m read

第105章 属性关键字 - OnDelete

指定删除相关对象时在当前表中采取的操作。此关键字仅适用于将基数Cardinality 指定为“父”或“一”的关系属性。它的使用在所有其他上下文中都是无效的。

用法

要指定删除相关对象时在当前表中采取的操作,请使用以下语法:

Relationship relname As classname [ Cardinality = cardinality, Inverse = inverse, OnDelete = ondelete ];

其中ondelete是以下值之一。在本讨论中,相关记录是属于关系另一方的记录或对象,引用记录是关系这一方的记录或对象。

  • cascade级联—删除相关记录时,也会删除该表中的引用记录。
  • noaction无操作—当试图删除相关记录时,尝试会失败。
  • setdefault —删除相关记录时,该表中的引用记录将被设置为其默认值。
  • setnull —删除相关记录时,该表中的引用记录将被设置为null

详解

此关键字定义了在关系的另一端删除记录时发生的引用操作。

默认

如果忽略此关键字,则:

0
0 115
文章 姚 鑫 · 八月 14, 2021 3m read

第101章 属性关键字 - InitialExpression

指定此属性的初始值。

用法

要指定此属性的初始值,请使用以下语法:

Property name As classname [ InitialExpression = initialexpression ];

其中,initialexpression是用大括号括起来的常量或ObjectScript表达式。

详解

此关键字指定属性的初始值。该值是在创建新实例时由类的%New()方法分配的。(如果属性是瞬态的的,则其初始值由创建实例时%New()调用的代码或实例从磁盘加载到内存时%OpenId()调用的代码确定。)

初始表达式的值必须适合给定的属性类型。

表达式可以是任意复杂的,有以下限制:

  • 初始表达式不能引用其他属性。也就是说,诸如{..therPropertyname}这样的表达式无效。
  • 初始表达式不能实例化对象,也不能包括对象引用。
  • 初始表达式不能调用实例方法(只能调用类方法)。
  • 必须在ObjectScript中指定初始表达式。
  • 表达式执行的代码不应报告错误。InterSystems IRIS不提供处理表达式返回的错误的方法。
  • 如果表达式执行的代码导致发生其他处理,则InterSystems IRIS不提供处理该处理结果的方法。

子类继承InitialExpression关键字的值并可以重写它。

默认

0
0 102
文章 姚 鑫 · 八月 13, 2021 2m read

第九十七章 属性关键字 - Collection

不推荐使用的方法是指定集合属性的集合类型。不要使用。

详解

此关键字已被“as”语法替换。

第九十八章 属性关键字 - Deprecated

指定此属性已弃用。此关键字被类编译器忽略,仅提供属性已弃用的人类可读指示符。

用法

要指定不推荐使用此属性,请使用以下语法:

Property name As classname [ Deprecated ]; 

否则,请省略此关键字或将该词放在该关键字之前。

第九十九章 属性关键字 - Final

指定此属性是否为最终属性(不能在子类中重写)。

用法

要指定属性为最终属性,请使用以下语法:

Property name As classname [ Final ];

否则,请省略此关键字或将该词放在该关键字之前。

详解

标记为Final的类成员不能在子类中被重写。

默认

如果省略此关键字,则该属性不是最终属性。

第100章 属性关键字 - Identity

指定此属性是否对应于相应SQL表中的IDENTITY列。适用于持久类。

用法

要指定此属性对应于相应SQL表中的IDENTITY列,请使用以下语法:

Property name As %Integer [ Identity ];

注意:属性类型可以是任何整数类型,例如%BigInt%Integer%SmallInt%TinyInt

否则,请省略此关键字或将该词放在该关键字之前。

详解

0
0 152
文章 Michael Lei · 八月 12, 2021 1m read

我最近看到一个客户问题,是使用 Caché 数据库上运行的病毒扫描程序导致应用程序间歇性变慢和用户响应时间不佳。

出乎意料的是,这是一个常见问题,所以本帖就是提个醒,要将主要 Caché 组件排除在病毒扫描之外。

通常,病毒扫描必须排除 CACHE.DAT 数据库文件和 Caché 二进制文件。 如果防病毒软件扫描 CACHE.DAT 和 InterSystems 文件,那么系统性能_将_受到较大影响。

具体来说,防病毒软件必须排除的 Caché 文件包括:

  • Caché 数据库 (CACHE.DAT)。
  • Ensemble/bin 或 cache/bin 目录中的 Caché 可执行文件。
  • 写入映像日志 (WIJ)。
  • 日志目录中的日志文件。

更多详细信息,请参见在线文档。

更多 Caché 文档

0
0 188
文章 姚 鑫 · 八月 12, 2021 3m read

第九十三章 属性关键字 - Aliases

指定此属性的其他名称,以便通过对象访问使用。

用法

要为属性指定其他名称,请使用以下语法:

Property name As classname [ Aliases=othernames ]; 

其中othernames是用逗号分隔的有效属性名列表,用大括号括起来。

详解

如果指定别名关键字,编译器会创建一个或多个给定的别名,这些别名指向原始属性所指向的同一基础数据。例如,重新定义Sample.PersonName属性,如下所示:

Property Name As %String(POPSPEC = "Name()") [ Aliases = {Alternate}, Required ];

然后,代码可以使用Name属性或等效的Alternate属性,如以下终端会话所示:

SAMPLES>set p=##class(Sample.Person).%OpenId(1)
 
SAMPLES>w p.Name
Fripp,Charles Z.
SAMPLES>w p.Alternate
Fripp,Charles Z.
SAMPLES>set p.Alternate="Anderson,Neville J."
 
SAMPLES>w p.Name
Anderson,Neville J.
0
0 106
文章 姚 鑫 · 八月 11, 2021 2m read

第八十九章 参数关键字 - Final

指定此参数是否为final(不能在子类中重写)

用法

要指定参数为final最终参数,请使用以下语法:

Parameter name As parameter_type  [ Final ] = value;

否则,请省略此关键字或将该词放在该关键字之前。

详解

标记为Final的类成员不能在子类中被重写。

默认

如果省略此关键字,则该参数不是最终参数。

第九十章 参数关键字 - Flags

修改此参数的用户接口类型(在Studio中)。

用法

要修改此参数的用户接口类型(在Studio中),请使用以下语法:

Parameter name As parameter_type  [ Flags = flags ] = value;

其中,flags 为以下值之一:

  • ENUM-该参数是由Constraint关键字(逗号分隔列表)指定的值之一。检查器将提供这些值的下拉列表。
  • LIST -参数值是由逗号分隔的项目列表组成的字符串。

请注意,不使用EDITEMPTYSYS

详解

修改参数的用户界面类型(在Studio中)。Studio使用此类型为检查器中的参数提供输入验证。类编译器忽略此关键字。

默认

如果省略此关键字,则Studio只允许该参数使用单个值(并且不提供选项下拉列表)。

第九十一章 映射关键字 - Internal

0
0 127
文章 姚 鑫 · 八月 10, 2021 3m read

第八十五章 方法关键字 - WebMethod

指定此方法是否为web method。仅适用于定义为web serviceweb客户端的类。

用法

要指定此方法是web方法,请使用以下语法:

Method name(formal_spec) As returnclass [ WebMethod ] 
{    //implementation }

否则,省略此关键字或将单词Not放在关键字的前面。

详解

此关键字指定此方法作为web方法可用,并且可以通过SOAP协议调用。

重要:在大多数情况下,web方法应该是实例方法,而不是类方法。

默认

如果省略此关键字,则该方法不能作为web method使用。

生成的类

当将此关键字添加到方法并编译类时,类编译器将生成一个额外的类:Package.OriginalClass.MethodNamePackage.OriginalClass是包含web方法的类,MethodNameweb方法的名称。

例如,从类ROBJDemo.DocLiteralWS开始。然后添加一个名为add的方法。当将WebMethod关键字添加到该方法并进行编译时,类编译器将生成类ROBJDemo.DocLiteralWS.Add

不要修改或直接使用这个生成的类; 仅供内部使用。

WSDL的关系

对于web服务,该关键字还会影响生成的WSDL,后者现在包含表示此web方法所需的附加元素。

0
0 181
文章 姚 鑫 · 八月 9, 2021 6m read

第八十一章 方法关键字 - SoapRequestMessage

当多个web方法具有相同的SoapAction时使用此方法。 在默认场景中,该关键字指定请求消息的SOAP正文中的顶级元素的名称。 仅适用于定义为web服务web客户端的类。

用法

要在请求消息的SOAP体中指定顶级元素的名称,请使用以下语法:

Method name(formal_spec) As returnclass [ WebMethod, SoapAction = "MyAct", SoapRequestMessage="MyReqMessage" ] 
{    //implementation }

其中soaprequestmessage是有效的XML标识符。

详解

注意:此关键字仅对包装的文档/文字document/literal消息有效。

对于包装的文档/文字消息,该关键字指定请求消息的SOAP主体中的顶部元素的名称。(默认情况下,包装文档/文字消息。

如果对同一web服务中的多个web方法使用相同的SoapAction值,请指定此关键字。否则,一般不需要这个关键字。

与WSDL的关系

SoapRequestMessage关键字影响web服务WSDL<Message>部分。例如,考虑以下web方法:

0
0 99
文章 姚 鑫 · 八月 8, 2021 7m read

第七十七章 方法关键字 - SoapBindingStyle

指定此方法用作web方法时使用的绑定样式或SOAP调用机制。仅适用于定义为web服务web客户端的类。

用法

若要重写方法使用的默认绑定样式(当它用作web方法时),请使用以下语法:

Method name(formal_spec) As returnclass [ WebMethod, SoapBindingStyle = soapbindingstyle ]  
{    //implementation }

其中soapbindingstyle是下列之一:

  • document文档(默认)—此web方法使用文档样式的调用。

使用这种绑定风格,SOAP消息被格式化为文档,并且通常只有一个部分。

SOAP消息中,<Body>元素通常包含一个子元素。<Body>元素的每个子元素对应于一个消息部分。

  • rpc —这个web方法使用rpc(远程过程调用)风格的调用。

使用这种绑定风格,SOAP消息被格式化为具有多个部分的消息。

SOAP消息中,<Body>元素包含一个子元素,其名称取自相应的操作名称。这个元素是一个生成的包装元素,它为方法的参数列表中的每个参数包含一个子元素。

0
0 165
文章 姚 鑫 · 八月 7, 2021 6m read

第七十三章 方法关键字 - Requires

指定用户或进程调用此方法必须拥有的权限列表。

用法

要指定此方法应限于具有指定权限的用户或进程,请使用以下语法:

Method name(formal_spec) As returnclass [ Requires = privilegelist ] 
{    //implementation } 

其中,privilegelist 要么是单个特权,要么是用引号括起来的以逗号分隔的特权列表。 每个权限都采用resource:permission的形式,其中permissionUseReadWrite(或单字母缩写URW)。

若要为一个资源resource指定多个权限,请使用单字母缩写。

详情

用户或进程必须拥有权限列表中的所有权限才能调用该方法。 调用没有指定权限的方法会导致<PROTECT>错误。

如果方法从超类继承了Requires关键字,则可以通过设置关键字的新值将其添加到所需特权的列表中。 不能以这种方式删除所需的特权。

默认

如果忽略此关键字,则调用此方法不需要特殊权限。

示例

下面的方法需要对Sales数据库的读权限和对Marketing数据库的写权限。 (注意,如果一个数据库有写权限,它会自动有读权限。)

0
0 90
文章 姚 鑫 · 八月 6, 2021 3m read

第六十九章 方法关键字 - PlaceAfter

指定此方法在为类生成的例程中相对于其他方法的顺序。

用法

要指定类编译器应该将此方法放在它为类创建的例程中列出的方法之后,请使用以下语法:

Method name(formal_spec) As returnclass [ PlaceAfter = methodlist ] 
{    //implementation } 

其中methodlist是单个方法名或用逗号分隔的方法名列表,用括号括起来。

详解

此关键字指定类编译器应该将此方法放在它为类创建的例程中列出的方法之后。此关键字用于极少数需要控制类编译器为方法生成代码的顺序的情况。

默认

如果省略此关键字,类编译器将使用其正常逻辑来确定它生成的例程中方法的顺序。

第七十章 方法关键字 - Private

指定此方法是否为私有方法(只能由该类或其子类的方法调用)。

用法

要指定该方法为私有方法,请使用以下语法:

Method name(formal_spec) As returnclass [ Private ] 
{    //implementation }

否则,请省略此关键字或将该词放在该关键字之前。

详情

私有类成员只能由同一类(或其子类)的其他成员使用。请注意,其他语言经常使用protected这个词来描述这种可见性,使用private这个词来表示不可见子类。

0
0 125
文章 TZ Zhuang · 八月 6, 2021 2m read

可以使用%SYS.Journal.File类中的ByTimeReverseOrder查询,以及%SYS.Journal.Record类中的List查询来实现。

下面是这两个查询的具体作用:

A) %SYS.Journal.File类中的ByTimeReverseOrder查询
这个查询会获取journal日志文件名并按降序排列

USER>set rs=##class(%ResultSet).%New("%SYS.Journal.File:ByTimeReverseOrder")
 
USER>do rs.Execute()
 
USER>while rs.Next() { write rs.Name,! }
c:\intersystems\cache\mgr\journal\20190620.003
c:\intersystems\cache\mgr\journal\20190620.002
c:\intersystems\cache\mgr\journal\20190620.001
c:\intersystems\cache\mgr\journal\20190610.001

B) %SYS.Journal.Record类中的List查询
这个查询可以从指定journal日志文件中获取日志记录

0
1 249
文章 姚 鑫 · 八月 5, 2021 3m read

第六十五章 方法关键字 - GenerateAfter

指定何时生成此方法。仅当方法是方法生成器时适用。

用法

要指定在生成其他方法后调用此方法的生成器,请使用以下语法:

Method name(formal_spec) As returnclass [ CodeMode = ObjectGenerator, GenerateAfter = methodlist ] 
{    //implementation } 

其中methodlist是单个方法名或用逗号分隔的方法名列表,用括号括起来。

详解

在方法生成器方法的情况下,指定生成器应在生成列出的方法后调用。当需要控制方法生成器的调用顺序时,此关键字非常有用。

第六十六章 方法关键字 - Internal

指定此方法定义是否是内部的(不显示在类文档中)。

用法

要指定此方法是内部的,请使用以下语法:

Method name(formal_spec) As returnclass [ Internal ] 
{    //implementation }

否则,省略此关键字或将单词Not放在关键字的前面。

详解

内部类成员不会显示在类文档中。如果想让用户看到一个类,但不看到它的所有成员,这个关键字很有用。

第六十七章 方法关键字 - Language

指定用于实现此方法的语言。

用法

要指定用于实现方法的语言,请使用以下语法:

0
0 137
文章 姚 鑫 · 八月 4, 2021 2m read

第六十一章 方法关键字 - Deprecated

指定不推荐使用此方法。该关键字被类编译器忽略,只是提供了一个人类可读的指示符,表明该方法已被弃用。

用法

要指定不推荐使用此方法,请使用以下语法:

Method name(formal_spec) As returnclass [ Deprecated ]  
{    //implementation }

否则,省略此关键字或将单词Not放在关键字的前面。

第六十二章 方法关键字 - ExternalProcName

当此方法在外部数据库中用作存储过程时,指定其名称。仅当方法被投影为存储过程时适用。

若要在方法用作外部数据库中的存储过程时重写该方法的默认名称,请使用以下语法:

ClassMethod name(formal_spec) As returnclass [ SqlProc, ExternalProcName = MyProcedure ] 
{    //implementation }

其中MyProcedure是一个不带引号的字符串。

详解

当此方法在外部数据库中用作存储过程时,此关键字允许定义此方法的名称。

默认

如果省略此关键字,方法名将用作存储过程名

第六十三章 方法关键字 - Final

指定此方法是否为最终方法(不能在子类中重写)。

用法

要指定方法是最终的,请使用以下语法:

0
0 133
文章 姚 鑫 · 八月 3, 2021 3m read

第五十七章 索引关键字 - Unique

指定索引是否应强制唯一性。

用法

要指定IRIS应强制此索引所基于的属性具有唯一性,请使用以下语法:

Index name On property_expression_list [ Unique ];

否则,请省略此关键字或将该词放在该关键字之前。

详情

如果存在UNIQUE关键字,则表示这是唯一索引。

由唯一索引索引的属性(或多个属性)被约束为在定义索引的类(表)的范围(所有对象的集合)内具有唯一值(即,没有两个实例可以具有相同的排序值)。

唯一索引不能也是位图索引。

示例

Index SSNIdx On SSN [ Unique ] ;

默认

如果省略此关键字,IRIS不会强制此索引所基于的属性具有唯一性。

第五十八章 方法关键字 - Abstract

指定这是否是抽象方法。

用法

要指定此方法是抽象的,请使用以下语法:

Method name(formal_spec) As returnclass [ Abstract ] {    //implementation }

否则,省略此关键字或将单词Not放在关键字的前面。

详解

抽象方法没有实现,也没有为其生成的可执行代码。抽象方法的存在仅仅是为了定义一个可以在一个或多个子类中被覆盖和实现的方法签名(或接口)。抽象方法的一些例子是在 IRIS类库中定义的但没有实现的各种回调方法。

默认

0
0 115
文章 姚 鑫 · 八月 2, 2021 2m read

第五十三章 索引关键字 - PrimaryKey

指定此索引是否定义表的主键。

用法

要指定该表的主键由该索引所基于的属性构成,请使用以下语法:

Index name On property_expression_list [ PrimaryKey ];

否则,省略此关键字或将单词Not放在关键字的前面。

详解

此关键字指定应通过SQL将此索引报告为此类(表)的主键。

PrimaryKey索引的行为也类似于唯一索引。 也就是说,对于在此索引中使用的属性(或属性组合),InterSystems IRIS强制唯一性。 在这个索引定义中,允许将Unique关键字指定为true,但这是多余的。

示例

Index EmpIDX On EmployeeID [ PrimaryKey] ;

默认

如果忽略此关键字,则该表的主键不是由索引所基于的属性构成的。

第五十四章 索引关键字 - ShardKey

指定这个类的分片键。

用法

在分片类完全实现之前,InterSystems建议从SQL创建分片表,而不是从对象端。 但是,如果你查看一个通过创建一个分片表生成的类,你可能会看到如下代码:

0
0 130
文章 姚 鑫 · 八月 1, 2021 3m read

第四十九章 索引关键字 - Data

指定其值将存储在此索引中的属性列表。

用法

要在索引, 中存储属性值,请使用以下语法:

Index name On property_expression_list [ Data = stored_property_list ];

其中,stored_property_list 是单个属性名称或括号中以逗号分隔的属性 , 列表。

详解

此关键字指定属性列表,其值将存储在此索引中。

不能将此关键字与位图索引一起使用。

默认

如果省略此关键字,属性值将不会存储在索引中。

示例

Index NameIDX On Name [ Data = Name ];

Index ZipIDX On ZipCode [ Data = (City,State) ];

第五十章 索引关键字 - Extent

定义范围索引。

用法

要指定这是范围索引,请使用以下语法:

Index State [ Extent ];

否则,省略此关键字或将单词Not放在关键字的前面。

注意:如果使用位图索引,则会自动维护一个范围索引,无需定义。

详解

extent index范围索引用于跟踪哪些对象实例属于某个子类。

默认

范围关键字的默认值为假。

第五十一章 索引关键字 - IdKey

指定此索引是否定义表的对象标识值。

用法

要指定该表的Object Identity值应该由索引所基于的一个或多个属性组成,请使用以下语法:

0
0 122
文章 姚 鑫 · 七月 31, 2021 2m read

第四十五章 外键关键字 - SqlName

为外键指定一个SQL别名。

用法

要覆盖此外键的默认SQL名称,请使用以下语法:

ForeignKey keyname(key_props) References pkg.class(ref_index) [ SqlName = alternate_name ];

其中备用名是一个SQL标识符。

详解

此关键字允许在通过SQL引用时定义此外键的替代名称。

默认

如果省略此关键字,外键的SQL名称就是外键定义中指定的keyname

第四十六章 索引关键字 - Abstract

指定索引是抽象的。

用法

要指定索引是抽象的,请使用以下语法:

Index MyIndex [ Abstract ];

注意:创建分片表时,会自动生成一个抽象分片键索引,无需定义。

详解

抽象索引仅用于分片表。它们不包含数据,因此没有存储(没有全局索引)。分片表只有一个抽象索引,称为分片键索引。分片键索引的目的是作为决定行所在分片的键。

如果索引被定义为抽象的,则不能通过方法或SQL访问或使用该索引。如果将此索引标记为唯一的,或者尝试在主键中使用它,这些约束将被忽略。

不能将IdKey索引定义为抽象索引。如果这样做,将会导致类编译错误。

可以在现有索引上使用此关键字,使其变得抽象。这不会删除索引中的任何现有数据。

默认

抽象关键字的默认值为false

第四十七章 索引关键字 - Condition

0
0 103
文章 姚 鑫 · 七月 30, 2021 3m read

第四十一章 外键关键字 - Internal

指定此外键定义是否为内部定义(不显示在类文档中)。

用法

要将此外键定义标记为内部,请使用以下语法:

ForeignKey keyname(key_props) References pkg.class(ref_index) [ Internal ];

否则,省略此关键字或将单词Not放在关键字的前面。

详解

内部类成员不会显示在类文档中。如果想让用户看到一个类,但不看到它的所有成员,这个关键字很有用。

默认

如果省略此关键字,此外键定义将显示在类文档中。

第四十二章 外键关键字 - NoCheck

指定是否应该检查这个外键约束。

用法

要防止检查该外键定义的约束,请使用以下语法:

ForeignKey keyname(key_props) References pkg.class(ref_index) [ NoCheck ];

否则,省略此关键字或将单词Not放在关键字的前面。

详解

NoCheck关键字禁止检查外键约束(换句话说,它指定外键约束永远不被检查)。

默认

如果省略这个关键字,会检查外键约束。

第四十三章 外键关键字 - OnDelete

指定当外部表中删除的记录被当前表中的记录引用时,此外部键应在当前表中引起的操作。

用法

要指定在外部表中删除引用的记录时在当前表中发生的情况,请使用以下语法:

0
0 110