Insertar, actualizar y eliminar miembros (XMLA)

Puede usar los comandos Insertar, Actualizar y Colocar en 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, consulte Write-Enabled Dimensiones.

Insertar nuevos miembros

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

Antes de construir el Insert comando, debe tener la siguiente información disponible para que se inserte el nuevo miembro:

• Dimensión en la que se van a insertar los nuevos miembros.

• Atributo de dimensión en el que se van a insertar los nuevos miembros.

• Los nombres de los nuevos miembros, incluidas las traducciones aplicables para el nombre.

• Claves de los nuevos miembros. Si un atributo usa una clave compuesta, la clave puede requerir varios valores.

• Valores de las propiedades de atributo aplicables que no se implementan como otros atributos dentro de la dimensión. Estas propiedades de atributo incluyen operaciones unarias, traducciones, resúmenes personalizados, propiedades de acumulación personalizadas y niveles omitidos.

El Insert comando solo toma dos propiedades:

• La 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 base de datos, el identificador de cubo y el identificador de dimensión de 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 Attribute elemento 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 que un único miembro se agregue al atributo identificado.

  Nota:

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

Actualizar miembros existentes

El Update comando 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 Update comando 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 definidos por los atributos primarios.

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

• Dimensión en la que se van a actualizar los miembros existentes.

• Atributos de dimensión en los que se van a actualizar los miembros existentes.

• Claves de los miembros existentes. Si un atributo usa una clave compuesta, la clave puede requerir varios valores.

• Valores de las propiedades de atributo aplicables que no se implementan como otros atributos dentro de la dimensión. Estas propiedades de atributo incluyen operaciones unarias, traducciones, resúmenes personalizados, propiedades de acumulación personalizadas y niveles omitidos.

El Update comando 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 base de datos, el identificador de cubo y el identificador de dimensión de la dimensión.

• La Attributes propiedad , que contiene uno o varios Attribute elementos para identificar los atributos en los que se van a actualizar los miembros. El Attribute elemento identifica un atributo y proporciona el nombre, el valor, las traducciones, el operador unario, el resumen 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 Attribute elemento. De lo contrario, puede producirse un error.

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

  Nota:

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

Actualizar miembros en atributos primarios

Para admitir atributos primarios, el Update comando las propiedades opcionales MoveWithDescendantsMovewithDescedants. Si se establece la MoveWithDescendants propiedad en true, se 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, mover un miembro primario hace que los descendientes inmediatos de ese miembro primario se promuevan al nivel en el que reside anteriormente el miembro primario.

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

Quitar miembros existentes

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

• Dimensión en la que se van a quitar los miembros existentes.

• Atributos de dimensión en los que se van a quitar los miembros existentes.

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

El Drop comando solo toma dos propiedades necesarias:

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

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

  Nota:

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

Quitar miembros en atributos primarios

Si se establece la propiedad DeleteWithDescendants , se indica que los descendientes de un miembro primario también deben eliminarse con el miembro primario. Si este valor se establece en false, los descendientes inmediatos del miembro primario se promueven al nivel en el que residía anteriormente el miembro primario.

Véase también

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