멤버 삽입, 업데이트 및 삭제(XMLA)Inserting, Updating, and Dropping Members (XMLA)

적용 대상:예SQL Server Analysis Services아니요Azure Analysis ServicesAPPLIES TO:yesSQL Server Analysis ServicesnoAzure Analysis Services사용할 수는 삽입, 업데이트, 및 Drop 명령은 xml에서 for Analysis (XMLA)를 삽입, 업데이트 또는 쓰기 가능 차원에서 멤버를 삭제 합니다. You can use the Insert, Update, and Drop commands in XML for Analysis (XMLA) to respectively insert, update, or delete members from a write-enabled dimension. 쓰기 가능 차원에 대 한 자세한 내용은 참조 쓰기 가능한 차원합니다.For more information about write-enabled dimensions, see Write-Enabled Dimensions.

새 멤버 삽입Inserting New Members

삽입 명령에서는 쓰기 가능 차원에서 지정 된 특성에 새 멤버를 삽입 합니다.The Insert command inserts new members into specified attributes in a write-enabled dimension.

생성 하기 전에 삽입 명령에 삽입할 새 멤버에 대해 다음 정보가 필요 합니다.Before constructing the Insert command, you should have the following information available for the new members to be inserted:

  • 새 멤버를 삽입할 차원.The dimension in which to insert the new members.

  • 새 멤버를 삽입할 차원 특성.The dimension attribute in which to insert the new members.

  • 이름의 적용할 수 있는 번역을 포함한 새 멤버의 이름.The names of the new members, including any applicable translations for the name.

  • 새 멤버의 키.The keys of the new members. 특성이 복합 키를 사용하는 경우 이 키에는 값이 여러 개 필요할 수 있습니다.If an attribute uses a composite key, the key may require multiple values.

  • 차원 내에서 다른 특성으로 구현되지 않은 적용 가능한 모든 특성 속성의 값.Values for any applicable attribute properties that are not implemented as other attributes within the dimension. 이러한 특성 속성에는 단항 연산, 번역, 사용자 지정 롤업, 사용자 지정 롤업 속성 및 건너뛴 수준이 있습니다.Such attribute properties include unary operations, translations, custom rollups, custom rollup properties, and skipped levels.

    삽입 명령은 두 개의 속성만 사용 합니다.The Insert command takes only two properties:

  • 개체 구성원을 삽입할 수 있는 차원에 대 한 개체 참조가 포함 된 속성입니다.The Object property, which contains an object reference for the dimension in which the members are to be inserted. 개체 참조는 차원에 대한 데이터베이스 식별자, 큐브 식별자 및 차원 식별자를 포함합니다.The object reference contains the database identifier, cube identifier, and dimension identifier for the dimension.

  • 특성 하나 이상 포함 된 속성을 특성 요소 삽입 멤버는 특성을 식별 합니다.The Attributes property, which contains one or more Attribute elements to identify the attributes in which members are to be inserted. 특성 요소는 특성을 식별 하 고 제공 이름, 값, 번역, 단항 연산자, 사용자 지정 롤업, 사용자 지정 롤업 속성 및 건너뛴 수준이 식별된 된 특성에 추가할 단일 멤버에 대 한 합니다.Each Attribute element identifies an attribute and provides the name, value, translations, unary operator, custom rollup, custom rollup properties, and skipped levels for a single member to be added to the identified attribute.

    참고

    에 대 한 모든 속성은 특성 요소가 포함 되어야 합니다.All properties for the Attribute element must be included. 그렇지 않으면 오류가 발생할 수 있습니다.Otherwise, an error may occur.

기존 멤버 업데이트Updating Existing Members

업데이트 명령에서는 쓰기 가능 차원에서 다른 특성의 다른 멤버와 관계를 기반으로 하는 지정 된 특성의 기존 멤버를 업데이트 합니다.The Update command updates existing members in specified attributes, based on relationships with other members in other attributes, in a write-enabled dimension. 업데이트 명령은 이동할 수 계층에 다른 수준으로 멤버를 차원에 포함 된 있으며 부모 특성에 의해 정의 된 부모-자식 계층 구조를 사용할 수 있습니다.The Update command can move members to other levels in hierarchies contained by the dimension, and can be used to restructure parent-child hierarchies defined by parent attributes.

생성 하기 전에 업데이트 명령을 멤버의 업데이트에 대 한 다음 정보가 필요 합니다.Before constructing the Update command, you should have the following information available for the members to be updated:

  • 기존 멤버를 업데이트할 차원.The dimension in which to update existing members.

  • 기존 멤버를 업데이트할 차원 특성.The dimension attributes in which to update existing members.

  • 기존 멤버의 키.The keys of the existing members. 특성이 복합 키를 사용하는 경우 이 키에는 값이 여러 개 필요할 수 있습니다.If an attribute uses a composite key, the key may require multiple values.

  • 차원 내에서 다른 특성으로 구현되지 않은 적용 가능한 모든 특성 속성의 값.Values for any applicable attribute properties that are not implemented as other attributes within the dimension. 이러한 특성 속성에는 단항 연산, 번역, 사용자 지정 롤업, 사용자 지정 롤업 속성 및 건너뛴 수준이 있습니다.Such attribute properties include unary operations, translations, custom rollups, custom rollup properties, and skipped levels.

    업데이트 명령에서는 세 개의 필수 속성만:The Update command takes only three required properties:

  • 개체 멤버를 업데이트할 수 있는 차원에 대 한 개체 참조가 포함 된 속성입니다.The Object property, which contains an object reference for the dimension in which the members are to be updated. 개체 참조는 차원에 대한 데이터베이스 식별자, 큐브 식별자 및 차원 식별자를 포함합니다.The object reference contains the database identifier, cube identifier, and dimension identifier for the dimension.

  • 특성 하나 이상 포함 된 속성을 특성 업데이트할 멤버는 특성을 식별 하는 요소입니다.The Attributes property, which contains one or more Attribute elements to identify the attributes in which members are to be updated. 특성 는 특성을 식별, 제공 된 이름, 값, 번역, 단항 연산자, 사용자 지정 롤업, 사용자 지정 롤업 속성 및 건너뛴 수준이 식별된 된 특성에 대해 업데이트 된 단일 멤버에 대 한 요소입니다.The Attribute element identifies an attribute and provides the name, value, translations, unary operator, custom rollup, custom rollup properties, and skipped levels for a single member updated for the identified attribute.

    참고

    에 대 한 모든 속성은 특성 요소가 포함 되어야 합니다.All properties for the Attribute element must be included. 그렇지 않으면 오류가 발생할 수 있습니다.Otherwise, an error may occur.

  • 여기서 하나 이상 포함 된 속성을 특성 멤버를 업데이트할 수 있는 특성을 제한 하는 요소입니다.The Where property, which contains one or more Attribute elements that constrain the attributes in which members are to be updated. 여기서 속성은 제한 하는 데 중요 한 업데이트 명령을 멤버의 특정 인스턴스로.The Where property is crucial to limiting an Update command to specific instances of a member. 경우는 여기서 속성이 지정 되지 않은, 지정된 된 멤버의 모든 인스턴스가 업데이트 됩니다.If the Where property is not specified, all instances of a given member are updated. 예를 들어, 세 명의 고객에 대한 도시 이름을 Redmond에서 Bellevue로 변경하려고 합니다.For example, there are three customers for whom you want to change the city name from Redmond to Bellevue. 도시 이름을 변경 하려면를 제공 해야는 여기서 City 특성의 멤버는 변경에 대해 특성은 고객의 세 멤버를 식별 하는 속성입니다.To change the city name, you must provide a Where property that identifies the three members in the Customer attribute for which the members in the City attribute should be changed. 이 제공 하지 않는 경우 여기서 속성, 모든 고객의 도시 이름이 현재 Redmond로 되어 bellevue로 변경 후 도시 이름을 갖기는 업데이트 명령 실행 합니다.If you do not provide this Where property, every customer whose city name is currently Redmond would have the city name of Bellevue after the Update command runs.

    참고

    새 멤버를 제외 하 고는 업데이트 명령에 포함 되지 않은 특성의 특성 키 값만 업데이트할 수는 여기서 절.With the exception of new members, the Update command can only update attribute key values for attributes not included in the Where clause. 예를 들어, 고객을 업데이트하는 경우 도시 이름을 업데이트할 수 없습니다. 이렇게 하지 않으면 모든 고객의 도시 이름이 변경됩니다.For example, the city name cannot be updated when a customer is updated; otherwise, the city name is changed for all customers.

부모 특성의 멤버 업데이트Updating Members in Parent Attributes

부모 특성을 지원 하지는 업데이트 명령에 선택적 MoveWithDescendants위해 속성입니다.To support parent attributes, the Update command the optional MoveWithDescendantsMovewithDescedants properties. 설정의 MoveWithDescendants 속성을 true로는 부모 멤버의 하위 항목도 이동 부모 멤버와 해당 부모 멤버의 식별자가 변경 하는 경우를 나타냅니다.Setting the MoveWithDescendants property to true indicates that the descendants of the parent member should also be moved with the parent member when the identifier of that parent member changes. 이 값을 false로 설정한 경우 부모 멤버를 이동하면 해당 부모 멤버의 직계 하위 항목이 부모 멤버의 이전 수준으로 승격됩니다.If this value is set to false, moving a parent member causes the immediate descendants of that parent member to be promoted to the level in which the parent member formerly resided.

부모 특성의 멤버를 업데이트할 때의 업데이트 명령은 다른 특성의 멤버를 업데이트할 수 없습니다.When updating members in a parent attribute, the Update command cannot update members in other attributes.

기존 멤버 삭제Dropping Existing Members

생성 하기 전에 Drop 명령을 삭제할 구성원에 대해 다음 정보가 필요 합니다.Before constructing the Drop command, you should have the following information available for the members to be dropped:

  • 기존 멤버를 삭제할 차원.The dimension in which to drop existing members.

  • 기존 멤버를 삭제할 차원 특성.The dimension attributes in which to drop existing members.

  • 삭제할 기존 멤버의 키.The keys of the existing members to be dropped. 특성이 복합 키를 사용하는 경우 이 키에는 값이 여러 개 필요할 수 있습니다.If an attribute uses a composite key, the key may require multiple values.

    Drop 명령에서는 두 개의 필수 속성만:The Drop command takes only two required properties:

  • 개체 삭제할 멤버는 차원에 대 한 개체 참조가 포함 된 속성입니다.The Object property, which contains an object reference for the dimension in which the members are to be dropped. 개체 참조는 차원에 대한 데이터베이스 식별자, 큐브 식별자 및 차원 식별자를 포함합니다.The object reference contains the database identifier, cube identifier, and dimension identifier for the dimension.

  • 여기서 하나 이상 포함 된 속성을 특성 멤버를 삭제할 수 있는 특성을 제한 하는 요소입니다.The Where property, which contains one or more Attribute elements to constrain the attributes in which members are to be deleted. 여기서 속성은 제한 하는 데 중요 한 Drop 명령을 멤버의 특정 인스턴스로.The Where property is crucial to limiting a Drop command to specific instances of a member. 경우는 여기서 명령을 지정 하지 않으면, 지정된 된 멤버의 모든 인스턴스가 삭제 됩니다.If the Where command is not specified, all instances of a given member are dropped. 예를 들어, Redmond의 고객 세 명을 삭제하려고 합니다.For example, there are three customers that you want to drop from Redmond. 이러한 고객을 삭제 하려면 제공 해야는 여기서 속성이 식별 하는 제거할 Customer 특성의 세 멤버와 세 고객을 제거할 City 특성 있는 Redmond 멤버입니다.To drop these customers, you must provide a Where property that identifies the three members in the Customer attribute to be removed and the Redmond member of the City attribute from which the three customers are to be removed. 경우는 여기서 속성에 City 특성의 Redmond 멤버 지정, Redmond에 연결 된 모든 고객이 삭제 됩니다는 Drop 명령입니다.If the Where property only specifies the Redmond member of the City attribute, every customer associated with Redmond would be dropped by the Drop command. 경우는 여기서 속성 Customer 특성의 세 멤버 지정와 세 고객을 통해 완전히 삭제 하려는 Drop 명령입니다.If the Where property only specifies the three members in the Customer attribute, the three customers would be deleted entirely by the Drop command.

    참고

    특성 에 포함 된 요소는 Drop 명령에만 포함 해야 합니다는 AttributeName 속성입니다.The Attribute elements included in a Drop command must contain only the AttributeName and Keys properties. 그렇지 않으면 오류가 발생할 수 있습니다.Otherwise, an error may occur.

부모 특성의 멤버 삭제Dropping Members in Parent Attributes

설정의 DeleteWithDescendants 속성 표시 하면 부모 멤버의 하위 부모 멤버와도 삭제 해야 합니다.Setting the DeleteWithDescendants property indicates that the descendants of a parent member should also be deleted with the parent member. 이 값을 false로 설정한 경우에는 부모 멤버의 직계 하위 항목이 부모 멤버의 이전 수준으로 승격됩니다.If this value is set to false, the immediate descendants of the parent member are instead promoted to the level in which the parent member formerly resided.

중요

부모 멤버와 해당 하위 항목을 모두 삭제하려면 부모 멤버에 대한 삭제 권한만 있으면 됩니다.A user needs only to have delete permissions for the parent member to delete both the parent member and its descendants. 하위 항목에 대한 삭제 권한은 필요하지 않습니다.A user does not need delete permissions on the descendants.

관련 항목:See Also

Drop 요소 ( XMLA ) Drop Element (XMLA)
요소 ( 삽입 XMLA ) Insert Element (XMLA)
Update 요소 ( XMLA ) Update Element (XMLA)
정의 및 개체 ( 식별 XMLA ) Defining and Identifying Objects (XMLA)
Analysis Services에서 XMLA를 사용하여 개발Developing with XMLA in Analysis Services