MDX Data Definitie - CREATE SET

Maakt een benoemde set aan met sessiescope voor de huidige kubus.

Syntax

  
CREATE [SESSION] [ STATIC | DYNAMIC ] [HIDDEN] SET   
   CURRENTCUBE | Cube_Name  
      .Set_Name AS 'Set_Expression'  
      [,Property_Name = Property_Value, ...n]  

Arguments

Cube_Name
Een geldige stringexpressie die de naam van de kubus geeft.

Set_Name
Een geldige stringexpressie die de naam geeft voor de benoemde set die wordt gemaakt.

Set_expressie
Een geldige Multidimensionale Expressies (MDX) expressie die een verzameling teruggeeft.

Property_Name
Een geldige string die de naam van een set-eigenschap geeft.

Property_Value
Een geldige scalaire expressie die de waarde van de set-eigenschap definieert.

Remarks

Een benoemde verzameling is een verzameling dimensieleden (of een expressie die een verzameling definieert) die je aanmaakt om opnieuw te gebruiken. Een benoemde set maakt het bijvoorbeeld mogelijk om een set dimensieleden te definiëren die bestaat uit de set van de top tien winkels per omzet. Deze verzameling kan statisch worden gedefinieerd, of via een functie zoals TopCount. Deze benoemde set kan vervolgens worden gebruikt waar de set van de top 10 winkels nodig is.

De CREATE-instructie SET creëert een benoemde set die gedurende de hele sessie beschikbaar blijft en daarom in meerdere queries binnen een sessie kan worden gebruikt. Voor meer informatie, zie Creating Session-Scoped Calculated Members (MDX).

Je kunt ook een benoemde set definiëren voor gebruik door één enkele query. Om zo'n set te definiëren, gebruik je de WITH-clausule in de SELECT-instructie. Voor meer informatie over de WITH-clausule, zie Creating Query-Scoped Named Sets (MDX).

De Set_Expression-clausule kan elke functie bevatten die MDX-syntaxis ondersteunt. Sets die met de CREATE-instructie SET zijn gemaakt en de SESSION-clausule niet specificeren, hebben sessiescope. Gebruik de WITH-clausule om een set met queryscope te maken.

Het specificeren van een kubus anders dan de kubus die momenteel verbonden is, veroorzaakt een fout. Daarom moet je CURRENTCUBE gebruiken in plaats van een kubusnaam om de huidige kubus aan te duiden.

Scope

Een door de gebruiker gedefinieerde set kan voorkomen binnen een van de scopes die in de volgende tabel worden vermeld.

Zoekbereik
De zichtbaarheid en levensduur van de set zijn beperkt tot de query. De set wordt gedefinieerd in een individuele query. Queryscope overschrijft sessiescope. Voor meer informatie, zie Creating Query-Scoped Named Sets (MDX).

Sessie-scope
De zichtbaarheid en levensduur van de set zijn beperkt tot de sessie waarin deze wordt gemaakt. (De levensduur is korter dan de sessieduur als er een DROP-instructie SET op de set wordt uitgegeven.) De CREATE-instructie SET maakt een set aan met sessiescope. Gebruik de WITH-clausule om een set met queryscope te maken.

Example

Het volgende voorbeeld creëert een set genaamd Core Products. De SELECT-query demonstreert vervolgens het aanroepen van de nieuw aangemaakte set. De CREATE-instructie SET moet worden uitgevoerd voordat de SELECT-query kan worden uitgevoerd - ze kunnen niet in dezelfde batch worden uitgevoerd.

CREATE SET [Adventure Works].[Core Products] AS '{[Product].[Category].[Bikes]}'  
  
SELECT [Core Products] ON 0  
  FROM [Adventure Works]  

Set-evaluatie

Verzamelingsevaluatie kan anders worden gedefinieerd; Het kan worden gedefinieerd als slechts één keer bij het creëren van de verzameling of kan worden gedefinieerd om elke keer dat de verzameling wordt gebruikt te voorkomen.

STATIC
Geeft aan dat de set slechts één keer wordt geëvalueerd op het moment dat de CREATE-instructie SET wordt geëvalueerd.

DYNAMIC
Geeft aan dat de verzameling elke keer wordt geëvalueerd wanneer deze in een query wordt gebruikt.

Zichtbaarheid instellen

De set kan zichtbaar zijn voor andere gebruikers die de kubus opvragen.

VERBORGEN
Geeft aan dat de set niet zichtbaar is voor gebruikers die de kubus opvragen.

Standaardeigenschappen

Elke set heeft een set standaardeigenschappen. Wanneer een clientapplicatie is verbonden met Analysis Services, worden de standaardeigenschappen ondersteund of beschikbaar om ondersteund te worden, zoals de beheerder kiest.

Zie ook

DROP-verklaring SET (MDX)
MDX Data Definitie Statements (MDX)