Insertar, actualizar y quitar miembros (XMLA)
Puede utilizar los comandos Insert, Update y Drop de XML for Analysis (XMLA) para insertar, actualizar o eliminar respectivamente los miembros de una dimensión habilitada para escritura. Para obtener más información acerca de las dimensiones habilitadas para escritura, vea Dimensiones habilitadas para escritura.
Insertar nuevos miembros
El comando Insert inserta nuevos miembros en atributos especificados de 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 van a insertar:
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 sólo acepta dos propiedades:
La propiedad Object, que contiene una referencia de objeto para la dimensión donde 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 más elementos Attribute para identificar los atributos donde se van a insertar los miembros. Cada elemento Attribute identifica un atributo y proporciona el nombre, el valor, las traducciones, el operador unario, el resumen personalizado, las propiedades de resúmenes personalizados y los niveles omitidos para un miembro único que se va a agregar al atributo identificado.
Nota
Deben incluirse todas las propiedades del elemento Attribute. De lo contrario, puede producirse un error.
Actualizar los miembros existentes
El comando Update actualiza los miembros existentes en 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 los miembros a otros niveles de jerarquías incluidas en la dimensión y se puede utilizar para reestructurar las jerarquías de elementos primarios y secundarios definidas por atributos primarios.
Antes de construir el comando Update, debe tener disponible la siguiente información para los miembros que se van a actualizar:
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 sólo acepta tres propiedades necesarias:
La propiedad Object, que contiene una referencia de objeto para la dimensión donde 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 más elementos Attribute para identificar los atributos donde se van a actualizar los miembros. El elemento Attribute identifica un atributo y proporciona el nombre, el valor, las traducciones, el operador unario, el resumen personalizado, las propiedades de resúmenes personalizados y los niveles omitidos para un miembro único actualizado para el atributo identificado.
Nota
Deben incluirse todas las propiedades del elemento Attribute. De lo contrario, puede producirse un error.
La propiedad Where, que contiene uno o más elementos Attribute que restringen los atributos donde 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 a los tres miembros en el atributo Customer para el deben cambiarse los miembros en el atributo City. Si no proporciona esta propiedad Where, todos los clientes cuyo nombre de ciudad sea actualmente Redmond tendrán el nombre de ciudad Bellevue después de ejecutarse el comando Update.
Nota
Con la excepción de los nuevos miembros, el comando Update sólo puede actualizar 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 garantizar la compatibilidad con atributos primarios, el comando Update utiliza las propiedades opcionales MoveWithDescendants. Si se establece la propiedad MoveWithDescendants en true se indica que los descendientes del miembro primario deben moverse junto con éste cuando cambie el identificador de dicho 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.
Cuando se actualizan los miembros de 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 los miembros que se van a 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 sólo acepta dos propiedades necesarias:
La propiedad Object, que contiene una referencia de objeto para la dimensión donde van a quitarse los miembros. La referencia de objeto incluye el identificador de la base de datos, el identificador del cubo y el identificador de la dimensión.
La propiedad Where, que contiene uno o más elementos Attribute para restringir los atributos donde 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 quitan 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 que se van a quitar en el atributo Customer y el miembro Redmond del atributo City del se van a quitar los tres clientes. Si la propiedad Where sólo especifica el miembro Redmond del atributo City, con el comando Drop se quitarán todos los clientes asociados a Redmond. Si la propiedad Where sólo especifica los tres miembros en el atributo Customer, el comando Drop eliminará por completo los tres clientes.
Nota
Los elementos Attribute incluidos en un comando Drop sólo deben contener las propiedades AttributeName y Keys. De lo contrario, puede producirse un error.
Quitar miembros de atributos primarios
Al establecer la propiedad DeleteWithDescendants se indica que los descendientes de un miembro primario deben eliminarse junto con éste. 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.
.gif "Nota de seguridad") Nota de seguridad |
|---|
Para eliminar el miembro primario y sus descendientes, un usuario sólo debe tener permisos de eliminación para el miembro primario. No es necesario que el usuario tenga permisos de eliminación para los descendientes. |