可以通过定义表(使用CREATE TABLE
)或通过定义投影到表的持久类来创建表:
由于以下原因,这两个名字之间的对应关系可能不相同:
SqlTableName
类关键字来提供不同的SQL表名。SQLUser
;
初始默认包名为“User”
。表、视图或存储过程名称可以是限定的(schema.name
),也可以是限定的(name
)。
模式名遵循标识符约定,需要特别注意非字母数字字符的使用。
模式名不应该指定为带分隔符的标识符。
尝试指定“USER”或任何其他SQL保留字作为模式名会导致SQLCODE -312
错误。
INFORMATION_SCHEMA
模式名和相应的信息。
模式包名在所有命名空间中保留。
用户不应该在这个模式/包中创建表/类。
当执行一个创建操作(比如create TABLE
),指定一个还不存在的模式时,InterSystems IRIS将创建新的模式。
InterSystems IRIS使用模式名生成相应的包名。
由于模式及其对应包的命名约定不同,用户应该注意非字母数字字符的名称转换注意事项。
这些名称转换的注意事项与表不同:
%
(percent):指定%作为模式名的第一个字符,表示相应的包为系统包,其所有类为系统类。
这种用法需要适当的权限;
否则,这种用法会发出一个SQLCODE -400
错误,%msg
表示<PROTECT>
错误。_
(下划线):如果模式名的第一个字符为下划线,则该字符将被对应包名中的小写“u”
替换。
例如,模式名_MySchema
生成名为uMySchema
的包。_
(下划线):如果模式名第一个字符以外的其他字符是下划线,则该字符将被对应包名中的句点(.
)替换。
由于句点是类的分隔符,下划线将模式分为包和子包。
因此,My_Schema
生成包含包模式(My.Schema
)的包My。@
, #
, $
characters:如果模式名包含任何这些字符,这些字符将从相应的包名中剥离。
如果剥离这些字符会产生重复的包名,那么将进一步修改剥离的包名:将剥离的模式名的最后一个字符替换为顺序整数(以0开始),以产生唯一的包名。
因此,My@#$Schema
生成MySchema
包,然后创建My#$Schema
生成MySchem0
包。
同样的规则也适用于表名对应的类名。INFORMATION_SCHEMA
模式名和相应的信息。
模式包名在所有命名空间中保留。
用户不应该在这个模式/包中创建表/类
在所有名称空间中保留IRIS_Shard
模式名。
用户不应在此模式中创建表、视图或过程。
存储在IRIS_Shard
模式中的项不会通过编目查询或INFORMATION_SCHEMA
查询显示。
初始设置是对所有名称空间(系统范围)使用相同的默认模式名。 可以为所有命名空间设置相同的默认模式名,也可以为当前命名空间设置默认模式名。
如果创建了一个具有非限定名称的表或其他项,InterSystems IRIS将为其分配默认模式名和相应的持久类包名。 如果一个命名的或默认的模式不存在,InterSystems IRIS将创建模式(和包),并将创建的项分配给该模式。 如果删除模式中的最后一项,InterSystems IRIS将删除该模式(和包)。 下面的模式名解析描述适用于表名、视图名和存储过程名。
系统范围的初始默认模式名是SQLUser
。
对应的持久类包名是User
。
因此,非限定表名Employee
或限定表名SQLUser
。
Employee
将生成类User.Employee
。
因为USER
是一个保留字,尝试用USER
的模式名(或任何SQL保留字)指定限定名会导致SQLCODE -1
错误。
要返回当前默认模式名,请调用$SYSTEM.SQL.DefaultSchema()
方法:
DHC-APP>WRITE $SYSTEM.SQL.DefaultSchema()
SQLUser
或者使用以下预处理器宏:
#Include %occConstant
WRITE $$$DefSchema
可以使用以下任意一种方式更改默认模式名:
SetDefaultSchema()
方法值覆盖。$SYSTEM.SQL.SetDefaultSchema()
方法。默认情况下,此方法在系统范围内设置默认架构名称。但是,通过将布尔值第3个参数设置为1,可以仅为当前名称空间设置默认架构。当不同的名称空间具有不同的默认架构名称时,DefaultSchema()
方法将返回当前名称空间的默认架构名称。注意:当更改默认的SQL模式名称时,系统将自动清除系统上所有名称空间中的所有缓存查询。 通过更改默认模式名称,可以更改所有包含非限定表、视图或存储过程名称的查询的含义。 强烈建议在安装InterSystems IRIS时建立默认的SQL模式名,以后不要修改。
模式名用于生成相应的类包名。 因为这些名称有不同的命名约定,所以它们可能不相同。
可以通过将其设置为系统范围的默认模式来创建与SQL保留字同名的模式,但是不建议这样做。
名为User
的默认模式根据类命名唯一性约定,生成相应的类包名称User0
。
_CURRENT_USER
关键字_CURRENT_USER
作为默认模式名,InterSystems IRIS将指定当前登录进程的用户名作为默认模式名。
_CURRENT_USER
值是$USERNAME
ObjectScript特殊变量值的第一部分。
如果$USERNAME
包含一个名字和一个系统地址(Deborah@TestSys
), _CURRENT_USER
只包含名字片段;
这意味着_CURRENT_USER
可以将相同的默认模式名分配给多个用户。
如果进程没有登录,_CURRENT_USER
指定SQLUser
作为默认的模式名。如果指定_CURRENT_USER/name
作为默认模式名,其中name是选择的任意字符串,那么InterSystems IRIS将当前登录进程的用户名分配为默认模式名。
如果进程没有登录,则name将用作默认的模式名。
例如,如果进程没有登录,_CURRENT_USER/HMO
使用HMO作为默认模式名。
在$SYSTEM.SQL.SetDefaultSchema()
中,指定"_CURRENT_USER"
作为带引号的字符串。
_CURRENT_USER
作为显式的模式名,InterSystems IRIS将其替换为当前系统范围内的默认模式。
例如,如果系统范围的默认模式是SQLUser
,则命令DROP TABLE _CURRENT_USER
。
OldTable SQLUser.OldTable
下降。
这是一种方便的方式来限定名称,以显式地指示应该使用系统范围的默认模式。
它在功能上与指定非限定名相同。
此关键字不能在DML语句中使用。当访问一个现有的表(或视图,或存储过程)进行DML操作时,将从模式搜索路径中提供一个非限定的名称。
按照指定的顺序搜索模式,并返回第一个匹配项。
如果在搜索路径中没有找到匹配的模式,或者没有搜索路径,则使用默认的模式名。
(注意,#Import
宏指令使用了不同的搜索策略,不会“失败”到默认的模式名。)
#SQLCompile Path
宏指令或#Import
宏指令来提供架构搜索路径,系统间IRIS使用该路径来解析非限定名称。
#SQLCompile Path
根据遇到的第一个匹配项解析不限定的名称。
如果搜索路径中列出的所有模式只有一个匹配项,则#Import
解析非限定名。#SQLCompile Path=Customers,Employees
%SchemaPath
属性提供模式搜索路径,系统间IRIS使用该路径解析不限定的表名。
可以直接指定%SchemaPath
属性,也可以将其指定为%SQL
的第二个参数。
声明%new()
方法。
下面的示例提供了包含两个模式名的搜索路径: SET tStatement = ##class(%SQL.Statement).%New(0,"Customers,Employees")
PATH SQL Shell
配置参数来提供架构搜索路径,系统间IRIS使用该路径解析不限定的名称。如果非限定名与模式搜索路径中指定的任何模式或默认模式名不匹配,则会发出SQLCODE -30
错误,例如:SQLCODE: -30
消息:Table 'PEOPLE' not found in schemas: CUSTOMERS,EMPLOYEES,SQLUSER
。
当创建一个基于odbc的查询以通过Mac上的Microsoft query从Microsoft Excel运行时,如果从可用的表列表中选择一个表,则生成的查询不包括该表的模式(相当于类的包)。
例如,如果选择从示例模式返回Person
表的所有行,则生成的查询为:
SELECT * FROM Person
因为InterSystems IRIS将不限定的表名解释为SQLUser
模式中的表名,所以该语句要么失败,要么从错误的表返回数据。
要纠正这一点,编辑查询(在SQL View选项卡上),显式引用所需的模式。
然后查询应该是:
SELECT * FROM Sample.Person
INFORMATION.SCHEMA
。
SCHEMATA persistent
类列出当前名称空间中的所有模式。
下面的示例返回当前命名空间中的所有非系统模式名:
SELECT SCHEMA_NAME
FROM INFORMATION_SCHEMA.SCHEMATA WHERE NOT SCHEMA_NAME %STARTSWITH '%'
Management Portal SQL界面的左侧允许查看模式(或匹配筛选器模式的多个模式)的内容。
每个表在其模式中都有一个唯一的名称。
一个表有一个SQL表名和一个对应的持久化类名;
这些名称在允许的字符、区分大小写和最大长度方面有所不同。
如果使用SQL CREATE TABLE
命令定义,则指定遵循标识符约定的SQL表名;
系统生成一个对应的持久化类名。
如果定义为持久类定义,则必须指定只包含字母和数字字符的名称;
这个名称既用作区分大小写的持久类名,也用作(默认情况下)对应的不区分大小写的SQL表名。
可选的SqlTableName class
关键字允许用户指定不同的SQL表名。
当使用CREATE TABLE
命令创建表时,InterSystems IRIS使用表名生成相应的持久化类名。
由于表及其对应类的命名约定不同,用户应该注意非字母数字字符的名称转换:
%
(percent): %作为表名的第一个字符是保留的,应该避免(参见标识符)。
如果指定了,%
字符将从对应的持久化类名中剥离。_
(下划线):如果表名的第一个字符是下划线,则该字符将从对应的持久化类名中剥离。
例如,表名_MyTable
生成类名MyTable
。SQLCODE -400
错误,%msg
值为" error #5053:类名'schema.name' is invalid "
(没有标点字符)。
例如,指定表名_7A
会生成%msg " ERROR #5053: Class name 'User.7A' is invalid "
。$ZNAME
测试,它就是一个有效的字母;
$ZNAME
字母验证因不同的地区而不同。
(注意,$ZNAME不能用于验证SQL标识符,因为标识符可能包含标点字符。)_
(下划线),@
,#
,$
characters:如果表名包含这些字符中的任何一个,这些字符将从对应的类名中剥离出来,并生成一个唯一的持久类名。
由于生成的类名不包括标点字符,因此不建议创建仅在标点字符上不同的表名。SQLCODE -201
错误。同一个模式中的视图和表不能具有相同的名称。
尝试这样做会导致SQLCODE -201
错误。
可以使用$SYSTEM.SQL.TableExists()
方法确定一个表名是否已经存在。
可以使用$SYSTEM.SQL.ViewExists()
方法确定视图名是否已经存在。
这些方法还返回与表或视图名称对应的类名。
管理门户SQL interface Catalog Details表信息选项显示与所选SQL表名称对应的类名。
试图指定“USER”
或任何其他SQL保留字作为表名或模式名会导致SQLCODE -312
错误。
要指定SQL保留字作为表名或模式名,可以指定名称作为带分隔符的标识符。
如果使用带分隔符的标识符指定包含非字母数字字符的表或模式名,InterSystems IRIS将在生成相应的类或包名时删除这些非字母数字字符。
适用以下表名长度限制:
在SQL中,每条记录都由一个唯一的整数值标识,这个整数值称为RowID
。
在InterSystems SQL中,不需要指定RowID
字段。
当创建表并指定所需的数据字段时,会自动创建RowID字段。
这个RowID
在内部使用,但没有映射到类属性。
默认情况下,只有当持久化类被投影到SQL表时,它的存在才可见。
在这个投影表中,将出现一个额外的RowID
字段。
默认情况下,这个字段被命名为“ID”
,并分配给第1列。
默认情况下,当在表中填充数据时,InterSystems IRIS将从1开始向该字段分配连续的正整数。RowID
数据类型为BIGINT(%Library.BigInt)
。为RowID
生成的值具有以下约束:每个值都是唯一的。不允许使用NULL
值。排序规则是精确的。默认情况下,值不可修改。
默认情况下,InterSystems IRIS将此字段命名为“ ID”
。但是,此字段名称不是保留的。每次编译表时都会重新建立RowID
字段名。如果用户定义了一个名为“ ID”
的字段,则在编译表时,InterSystems IRIS会将RowID
命名为“ ID1”
。例如,如果用户随后使用ALTER TABLE
定义了一个名为“ ID1”
的字段,则表编译会将RowID
重命名为“ ID2”
,依此类推。在持久性类定义中,可以使用SqlRowIdName
类关键字直接为此类投影到的表指定RowID
字段名。由于这些原因,应避免按名称引用RowID
字段。
InterSystems SQL提供了%ID
伪列名称(别名),无论分配给RowID
的字段名称如何,该伪列名称始终返回RowID
值。 (InterSystems TSQL提供了$IDENTITY
伪列名称,其作用相同。)
ALTER TABLE
无法修改或删除RowID
字段定义。
将记录插入表中后,InterSystems IRIS将为每个记录分配一个整数ID值。 RowID
值始终递增。它们不被重用。因此,如果已插入和删除记录,则RowID
值将按升序排列,但可能不连续。
CREATE TABLE
定义的表使用$SEQUENCE
执行ID
分配,从而允许多个进程快速同时填充该表。当使用$SEQUENCE
填充表时,会将RowID
值序列分配给进程,然后该进程将顺序分配它们。因为并发进程使用它们自己分配的序列分配RowID
,所以不能假定多个进程插入的记录按插入顺序排列。可以通过设置SetDDLUseSequence()
方法,将InterSystems IRIS配置为使用$INCREMENT
执行ID
分配。若要确定当前设置,请调用$ SYSTEM.SQL.CurrentSettings()
方法。
$INCREMENT
执行ID分配。在持久性类定义中,可以将IdFunction
存储关键字设置为序列或增量;否则,可以设置为0。例如,<IdFunction>序列</ IdFunction>
。在持久性类定义中,IdLocation
存储关键字global(例如,对于持久性类Sample.Person:<IdLocation> ^ Sample.PersonD </ IdLocation>
)包含RowID计数器的最高分配值。 (这是分配给记录的最高整数,而不是分配给进程的最高整数。)请注意,此RowID计数器值可能不再与现有记录相对应。要确定是否存在具有特定RowID值的记录,请调用表的%ExistsId()
方法。
通过TRUNCATE TABLE
命令重置RowID
计数器。即使使用DELETE
命令删除表中的所有行,也不会通过DELETE
命令将其重置。如果没有数据插入表中,或者已使用TRUNCATE TABLE
删除所有表数据,则IdLocation
存储关键字全局值未定义。
默认情况下,RowID
值不可用户修改。尝试修改RowID
值会产生SQLCODE -107
错误。覆盖此默认值以允许修改RowID
值可能会导致严重的后果,只有在非常特殊的情况下并应格外谨慎。 Config.SQL.AllowRowIDUpdate
属性允许RowID
值是用户可修改的。
通过定义一个用于投影表的持久类,可以定义RowID
以具有字段或字段组合中的值。为此,请使用IdKey index
关键字指定一个索引。例如,一个表可以具有一个RowID
,其RowId
通过在PatientName [IdKey]
上指定索引定义IdxId
来与PatientName
字段的值相同;或者可以通过指定索引定义IdxId
来将PatientName
和SSN
字段的组合值在(PatientName,SSN)[IdKey];
上。
RowID
效率比采用系统分配的连续正整数的RowId
效率低。INSERT
上:为构成RowId
的字段或字段组合指定的值必须唯一。指定非唯一值将生成SQLCODE -119
“在插入时唯一性或主键约束唯一性检查失败”。UPDATE
上:默认情况下,组成RowId
的每个字段的值都是不可修改的。尝试修改这些字段之一的值会生成SQLCODE -107
“无法基于字段更新RowID
或RowID
”。当RowID
基于多个字段时,RowID
值是由||
连接的每个组成字段的值。操作员。例如,Ross,Betsy || 123-45-6789
。 InterSystems IRIS尝试确定基于多个字段的RowID
的最大长度。如果无法确定最大长度,则RowID
长度默认为512。
CREATE TABLE
创建表时,默认情况下隐藏RowID
。 SELECT *
不会显示隐藏字段,而是PRIVATE
。创建表时,可以指定%PUBLICROWID
关键字以使RowID
不隐藏和公开。可以在CREATE TABLE
逗号分隔的表元素列表中的任何位置指定此可选的%PUBLICROWID
关键字。不能在ALTER TABLE
中指定。RowID
。它由SELECT *
显示,并且是PUBLIC
。可以通过指定类关键字SqlRowIdPrivate
来定义具有隐藏且为PRIVATE
的RowID
的持久类。用作外键引用的RowID
必须是公共的。
默认情况下,不能将具有公共RowID
的表用作源表或目标表,以使用INSERT INTO Sample.DupTable SELECT * FROM Sample.SrcTable
将数据复制到重复表中。
可以使用Management Portal SQL界面“目录详细信息字段”列出“隐藏”列来显示RowID
是否被隐藏。
可以使用以下程序返回指定字段(在此示例中为ID
)是否被隐藏:
/// d ##class(PHA.TEST.SQL).RowID()
ClassMethod RowID()
{
SET myquery = "SELECT FIELD_NAME,HIDDEN FROM %Library.SQLCatalog_SQLFields(?) WHERE FIELD_NAME='ID'"
SET tStatement = ##class(%SQL.Statement).%New()
SET qStatus = tStatement.%Prepare(myquery)
IF qStatus'=1 {
WRITE "%Prepare failed:"
DO $System.Status.DisplayError(qStatus)
QUIT
}
SET rset = tStatement.%Execute()
DO rset.%Display()
WRITE !,"End of data"
}
本文系转载,前往查看
如有侵权,请联系 cloudcommunity@tencent.com 删除。
本文系转载,前往查看
如有侵权,请联系 cloudcommunity@tencent.com 删除。