Name 要素 (ASSL)
親要素の名前が格納されます。
構文
<Action> <!-- or one of the elements listed below in the Element Relationships table -->
...
<Name>...</Name>
...
</Action>
要素の特性
特徴 | 説明 |
---|---|
データ型と長さ | String (最大 100 文字) |
既定値 | 場合により異なる |
カーディナリティ | 1-1: 1 回だけ発生する必須要素 |
要素の関係
解説
オブジェクト (Analysis Services のインスタンス、階層、属性など) を定義するために使用される要素には、プロパティとして Name 要素があります。 Name 要素の 値には 、次の制限があります。
値の先頭または末尾にスペースを含めることはできません。 先頭または末尾のスペースが Name 要素の値に含まれている場合、これらのスペースはAnalysis Services によって暗黙的に削除されます。
値に制御文字を含めることはできません。 名前には制御文字を含めないでください。制御文字が含まれていると、XML 検証エラーが発生する場合があります。
SQL Server で GetNewName メソッドを使用して作成されたオブジェクトの場合、AMO は名前の制御文字、先頭のスペース、または末尾のスペースをチェックして削除します。 このため、 GetNewName の使用は 、オブジェクト名を設定する場合に推奨される方法です。
ただし、Name プロパティを 直接設定 した場合、同じ検証チェックは実行されません。その結果、XML 検証エラーが発生する可能性があります。 エラーが実際に発生するかどうかは、名前に含まれる制御文字によって左右されます。
オブジェクト名には制御文字を使用しないようにする必要がありますが、Analysis Services では制御文字を明示的に禁止しているわけではありません。 以前のリリースの Analysis Services では、オブジェクト名の制御文字が許容される場合がありました。 このため、2016 SQL Server 以降ではAnalysis Services古いソリューションが破損しないように、オブジェクト名の制御文字が無視されます。
次の値は予約済みなので使用できません。
AUX
CLOCK$
COM1 ~ COM9 (COM1、COM2、COM3 など)
CON
LPT1 ~ LPT9 (LPT1、LPT2、LPT3 など)
NUL
PRN
次の表に、親要素に応じて Name 要素の値内で使用できない追加の文字を示します。
親要素 | 無効な文字 |
---|---|
[サーバー] | 名前は、コンピューター名の規則に従Windows必要があります。 IP アドレスは無効です。 |
DataSource | :/\\*|?"()[]{}<> ` |
Level、 Attribute 要素 | .,;':/\\*|?"&%$!+=[]{}<> ` |
他のすべての親要素 | .,;':/\\*|?"&%$!+=()[]{}<> ` |