Creating and Altering Objects (XMLA)
Głównych obiektów może być niezależnie utworzone, zmienione i usunięte.Obiekty główne obejmują następujące obiekty:
Serwery
Bazy danych
Wymiary
Moduły
Grupy miar
Partycje
Perspektywy
Modele wyszukiwania
Role
Polecenia związane z serwerem lub bazy danych
Źródła danych
You use the Create command to create a major object on an instance of Microsoft SQL Server Analysis Services, and the Alter command to alter an existing major object on an instance.Oba polecenia są uruchamiane przy użyciu wykonać metoda.
Tworzenie obiektów
Tworzenie obiektów przy użyciu Create Metoda, należy najpierw zidentyfikować obiekt nadrzędny, zawierający Analysis Services obiekt ma zostać utworzony. Identyfikowanie obiektu nadrzędnego przez podanie odwołania do obiektu w ParentObject Właściwość Create polecenie. Każde odwołanie do obiektu zawiera identyfikatory obiektów niezbędnych do jednoznacznej identyfikacji obiektu nadrzędnego dla Create polecenie. Aby uzyskać więcej informacji na temat odwołań do obiektu zobacz Defining and Identifying Objects (XMLA).
Na przykład, trzeba podać odwołanie do obiektu z kostką, aby utworzyć nową miara grupy dla moduł.Odwołanie do obiektu w module ParentObject Właściwość zawiera identyfikator bazy danych i identyfikator moduł, jak ten sam identyfikator moduł potencjalnie może być użyty na innej bazy danych.
The ObjectDefinition element contains Analysis Services wykonywanie skryptów Language (ASSL) elements that define the major object to be created.Aby uzyskać więcej informacji na temat ASSL zobacz ASSL.
Jeśli użytkownik zestaw AllowOverwrite atrybut Create polecenie ma wartość true, można zastąpić istniejącego obiektu głównych, zawierającą określony identyfikator. W przeciwnym razie wystąpi błąd jeśli istnieje główny obiekt, który został już określony identyfikator w obiekcie nadrzędnym.
Aby uzyskać więcej informacji na temat Create polecenia, zobacz Utwórz element (XMLA).
Tworzenie obiektów sesja
Obiektów sesja są tymczasowe obiekty, które są dostępne tylko dla sesja bezpośrednie lub pośrednie, używane przez aplikację klient i są usuwane po zakończeniu sesja.Można utworzyć obiektów sesja, ustawiając Scope atrybut Create polecenie Session.
Uwaga
Podczas korzystania z Session Ustawianie, ObjectDefinition element może zawierać tylko Wymiar, Moduł, or MiningModel Elementy ASSL.
Modyfikowanie obiektów
Podczas modyfikowania obiektów za pomocą Alter Metoda, należy najpierw zidentyfikować obiekt ma zostać zmodyfikowany przez podanie odwołania do obiektu w Obiekt Właściwość Alter polecenie. Każde odwołanie do obiektu zawiera identyfikatory obiektów niezbędnych do jednoznacznej identyfikacji obiektu dla Alter polecenie. Aby uzyskać więcej informacji na temat odwołań do obiektu zobacz Defining and Identifying Objects (XMLA).
Na przykład musisz podać odwołanie do obiektu z kostką w celu zmiany struktury moduł.Odwołanie do obiektu w module Object Właściwość zawiera identyfikator bazy danych i identyfikator moduł, jak ten sam identyfikator moduł potencjalnie może być użyty na innej bazy danych.
The ObjectDefinition element contains ASSL elements that define the major object to be modified.Aby uzyskać więcej informacji na temat ASSL zobacz ASSL.
Jeśli użytkownik zestaw AllowCreate atrybut Alter polecenie ma wartość true, można utworzyć określony obiekt główny, jeśli obiekt nie istnieje. W przeciwnym razie wystąpi błąd, jeśli określony obiekt główny nie istnieje.
Za pomocą atrybut ObjectExpansion
Jeśli zmieniasz tylko właściwości głównych obiektu i nie są przedefiniowanie obiekty pomocnicze, które znajdują się w głównych obiektów, zestaw ObjectExpansion atrybut Alter polecenie ObjectProperties. The ObjectDefinition właściwość then only has to contain the elements for the properties of the major object, and the Alter command leaves minor objects associated with the major object untouched.
Aby zmienić definicję obiekty pomocnicze dla obiektu głównych, należy zestaw ObjectExpansion atrybut do ExpandFull i definicji obiektu musi zawierać wszystkie obiekty pomocnicze, które znajdują się w głównym obiektu. Jeśli ObjectDefinition Właściwość Alter polecenie nie zawiera jawnie pomocnicze obiekt, który jest zawarty w głównych obiektów, pomocnicze obiekt, który nie został dołączony jest usuwany.
Modyfikowanie obiektów sesja
Do modyfikowania obiektów sesja utworzonych przez Create polecenie zestaw Scope atrybut Alter polecenie Session.
Uwaga
Podczas korzystania z Session Ustawianie, ObjectDefinition element może zawierać tylko Wymiar, Moduł, or MiningModel Elementy ASSL.
Tworzenie lub zmienianie podrzędny obiektów
Chociaż Create lub Alter polecenie tworzy lub modyfikuje tylko jeden obiekt główny najwyższego poziomu, główne obiektu jest tworzone lub modyfikowane mogą zawierać definicje w ciągu zawierającym ObjectDefinition Właściwość dla innych obiektów głównych i pomocniczych, które są podrzędne w stosunku do niego. Na przykład po zdefiniowaniu moduł bazę można określić obiektu nadrzędnego w ParentObject, a w ramach definicji moduł w ObjectDefinition do definiowania grup miar dla moduł, a w ramach grup miar można określić partycje dla każdej grupa miar. Obiekt pomocnicze mogą być definiowane tylko w głównych obiekt, który go zawiera.Aby uzyskać więcej informacji na temat obiektów główne i pomocnicze zobacz Database Objects (Analysis Services - Multidimensional Data).
Przykłady
Description
The following example creates a relational data source that references the Adventure Works DW sample Microsoft SQL Server database.
Code
<Create xmlns="https://schemas.microsoft.com/analysisservices/2003/engine">
<ParentObject>
<DatabaseID>Adventure Works DW</DatabaseID>
</ParentObject>
<ObjectDefinition>
<DataSource xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="RelationalDataSource">
<ID>Adventure Works DW</ID>
<Name>Adventure Works DW</Name>
<ConnectionString>Data Source=localhost;Initial Catalog=AdventureWorksDW;Integrated Security=True</ConnectionString>
<ImpersonationInfo>
<ImpersonationMode>ImpersonateServiceAccount</ImpersonationMode>
</ImpersonationInfo>
<ManagedProvider>System.Data.SqlClient</ManagedProvider>
<Timeout>PT0S</Timeout>
</DataSource>
</ObjectDefinition>
</Create>
Description
W poniższym przykładzie zmienia urządzenie źródłowe danych relacyjnych utworzonego w poprzednim przykładzie, aby zestaw limit czas kwerendy dla urządzenie źródłowe danych do 30 sekund.
Code
<Alter ObjectExpansion="ObjectProperties" xmlns="https://schemas.microsoft.com/analysisservices/2003/engine">
<Object>
<DatabaseID>Analysis Services Project1</DatabaseID>
<DataSourceID>Adventure Works DW2</DataSourceID>
</Object>
<ObjectDefinition>
<DataSource xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="RelationalDataSource">
<ID>Adventure Works DW2</ID>
<Name>Adventure Works DW2</Name>
<ConnectionString>Data Source=fr-dwk-02;Initial Catalog=AdventureWorksDW;Integrated Security=True</ConnectionString>
<ManagedProvider>System.Data.SqlClient</ManagedProvider>
<Timeout>PT30S</Timeout>
</DataSource>
</ObjectDefinition>
</Alter>
Komentarze
The ObjectExpansion atrybut of the Alter command was zestaw to ObjectProperties. To ustawienie umożliwia ImpersonationInfo pomocnicze obiektu, mają być wyłączone ze urządzenie źródłowe danych, zdefiniowanego w elementObjectDefinition. Dlatego informacje personifikacji dla danych urządzenie źródłowe pozostanie ustawiona na konta usługa, jak określono w pierwszym przykładzie.
See Also