Insertar, actualizar y quitar miembros (XMLA)

Puede usar los comandos Insert, Update y Drop de XML for Analysis (XMLA) para insertar, actualizar o eliminar miembros respectivamente de una dimensión habilitada para escritura. Para obtener más información sobre las dimensiones habilitadas para escritura, vea Dimensiones habilitadas para escritura.

Insertar nuevos miembros

El comando Insert inserta nuevos miembros en los atributos especificados en una dimensión habilitada para escritura.

Antes de construir el comando Insert , debe tener disponible la siguiente información para los nuevos miembros que se insertarán:

• La dimensión donde se van a insertar los nuevos miembros.

• El atributo de la dimensión donde se van a insertar los nuevos miembros.

• Los nombres de los nuevos miembros, incluida cualquier traducción aplicable del nombre.

• Las claves de los nuevos miembros. Si un atributo utiliza una clave compuesta, la clave puede requerir varios valores.

• Los valores de cualquier propiedad de atributo aplicable que no se implemente como otros atributos en la dimensión. Entre estas propiedades de atributo se incluyen operaciones unarias, traducciones, resúmenes personalizados, propiedades de resúmenes personalizados y niveles omitidos.

El comando Insert solo toma dos propiedades:

• Propiedad Object , que contiene una referencia de objeto para la dimensión en la que se van a insertar los miembros. La referencia de objeto contiene el identificador de la base de datos, el identificador del cubo y el identificador de dimensión para la dimensión.

• La propiedad Attributes , que contiene uno o varios elementos Attribute para identificar los atributos en los que se van a insertar los miembros. Cada elemento Attribute identifica un atributo y proporciona el nombre, el valor, las traducciones, el operador unario, el paquete acumulativo personalizado, las propiedades de acumulación personalizadas y los niveles omitidos para agregar un único miembro al atributo identificado.

  Nota

  Se deben incluir todas las propiedades del elemento Attribute. De lo contrario, puede producirse un error.

Actualizar los miembros existentes

El comando Actualizar actualiza los miembros existentes en los atributos especificados, en función de las relaciones con otros miembros de otros atributos, en una dimensión habilitada para escritura. El comando Update puede mover miembros a otros niveles de jerarquías contenidas en la dimensión y se puede usar para reestructurar las jerarquías de elementos primarios y secundarios definidas por atributos primarios.

Antes de construir el comando Update , debe tener la siguiente información disponible para que los miembros se actualicen:

• La dimensión donde se van a actualizar los miembros existentes.

• Los atributos de la dimensión donde se van a actualizar los miembros existentes.

• Las claves de los miembros existentes. Si un atributo utiliza una clave compuesta, la clave puede requerir varios valores.

• Los valores de cualquier propiedad de atributo aplicable que no se implemente como otros atributos en la dimensión. Entre estas propiedades de atributo se incluyen operaciones unarias, traducciones, resúmenes personalizados, propiedades de resúmenes personalizados y niveles omitidos.

El comando Update solo toma tres propiedades necesarias:

• Propiedad Object , que contiene una referencia de objeto para la dimensión en la que se van a actualizar los miembros. La referencia de objeto contiene el identificador de la base de datos, el identificador del cubo y el identificador de dimensión para la dimensión.

• La propiedad Attributes , que contiene uno o varios elementos Attribute para identificar los atributos en los que se van a actualizar los miembros. El elemento Attribute identifica un atributo y proporciona el nombre, el valor, las traducciones, el operador unario, el paquete acumulativo personalizado, las propiedades de acumulación personalizadas y los niveles omitidos para un único miembro actualizado para el atributo identificado.

  Nota

  Se deben incluir todas las propiedades del elemento Attribute. De lo contrario, puede producirse un error.

• La propiedad Where , que contiene uno o varios elementos Attribute que restringen los atributos en los que se van a actualizar los miembros. La propiedad Where es fundamental para limitar un comando Update a instancias específicas de un miembro. Si no se especifica la propiedad Where, se actualizan todas las instancias de un miembro determinado. Por ejemplo, hay tres clientes para los que desea cambiar el nombre de ciudad de Redmond a Bellevue. Para cambiar el nombre de la ciudad, debe proporcionar una propiedad Where que identifique los tres miembros del atributo Customer para los que se deben cambiar los miembros del atributo City. Si no proporciona esta propiedad Where , todos los clientes cuyo nombre de ciudad es redmond actualmente tendrían el nombre de ciudad Bellevue después de que se ejecute el comando Update.

  Nota

  A excepción de los nuevos miembros, el comando Update solo puede actualizar los valores de clave de atributo para los atributos no incluidos en la cláusula Where . Por ejemplo, el nombre de ciudad no se puede actualizar cuando se actualiza un cliente; de lo contrario, dicho nombre se cambia para todos los clientes.

Actualizar miembros de atributos primarios

Para admitir atributos primarios, el comando Update incluye las propiedades opcionales MoveWithDescendantsMovewithDescedants. Establecer la propiedad MoveWithDescendants en true indica que los descendientes del miembro primario también deben moverse con el miembro primario cuando cambia el identificador de ese miembro primario. Si este valor se establece en false, al mover un miembro primario, los descendientes inmediatos de dicho miembro ascienden al nivel donde residía anteriormente el miembro primario.

Al actualizar miembros en un atributo primario, el comando Update no puede actualizar los miembros de otros atributos.

Quitar miembros existentes

Antes de construir el comando Drop , debe tener disponible la siguiente información para que los miembros se puedan quitar:

• La dimensión donde se van a quitar miembros existentes.

• Los atributos de la dimensión donde se van a quitar miembros existentes.

• Las claves de los miembros existentes que se van a quitar. Si un atributo utiliza una clave compuesta, la clave puede requerir varios valores.

El comando Drop solo toma dos propiedades necesarias:

• Propiedad Object , que contiene una referencia de objeto para la dimensión en la que se van a descartar los miembros. La referencia de objeto contiene el identificador de la base de datos, el identificador del cubo y el identificador de dimensión para la dimensión.

• La propiedad Where , que contiene uno o varios elementos Attribute para restringir los atributos en los que se van a eliminar los miembros. La propiedad Where es fundamental para limitar un comando Drop a instancias específicas de un miembro. Si no se especifica el comando Where, se descartan todas las instancias de un miembro determinado. Por ejemplo, quiere quitar tres clientes de Redmond. Para quitar estos clientes, debe proporcionar una propiedad Where que identifique los tres miembros del atributo Customer que se van a quitar y el miembro Redmond del atributo City del que se van a quitar los tres clientes. Si la propiedad Where solo especifica el miembro Redmond del atributo City, el comando Drop quitará todos los clientes asociados a Redmond. Si la propiedad Where solo especifica los tres miembros del atributo Customer, el comando Drop eliminaría completamente los tres clientes.

  Nota

  Los elementos Attribute incluidos en un comando Drop solo deben contener las propiedades AttributeNamey Keys . De lo contrario, puede producirse un error.

Quitar miembros de atributos primarios

Establecer la propiedad DeleteWithDescendants indica que los descendientes de un miembro primario también se deben eliminar con el miembro primario. Sin embargo, si este valor se establece en false, los descendientes inmediatos del miembro primario ascienden al nivel donde residía anteriormente el miembro primario.

Consulte también

Elemento Drop (XMLA)
Elemento Insert (XMLA)
Elemento Update (XMLA)
Definir e identificar objetos (XMLA)
Desarrollar con XMLA en Analysis Services