Condividi tramite

Finestra di dialogo Modifica avanzata (Condizione)

  • Articolo

Utilizzare la finestra di dialogo Modifica avanzata per creare espressioni complesse per le condizioni della gestione basata su criteri.

Opzioni

  • Valore cella
    Visualizza la funzione o l'espressione che verrà utilizzata per il valore della cella quando viene creata. Quando si fa clic su OK il valore della cella verrà visualizzato nella cella Campo o Valore della casella dell'espressione della condizione nella finestra di dialogo Crea nuova condizione o Apri condizione della pagina Generale.

  • Funzioni e proprietà
    Visualizza le funzioni e le proprietà disponibili.

  • Dettagli
    Visualizza informazioni sulle funzioni e sulle proprietà nel formato seguente: firma funzione, descrizione funzione, valore restituito ed esempio.

Sintassi

Le espressioni valide devono avere il formato seguente:

{property | function | constant}

{operator}

{property | function | constant}

Esempi

Di seguito sono riportati alcuni esempi di espressioni valide:

  • Property1 > 5

  • Property1 = Property2

  • Add(5, Multiply(.2, Property1)) < Property2

  • Sometext IN Property1

  • Property1 < Fn(Property2)

  • BitwiseAnd(Property1, Property2) = 0

Ulteriori informazioni sulle funzioni

Nelle sezioni seguenti vengono fornite ulteriori informazioni sulle funzioni che è possibile utilizzare per creare espressioni complesse per le condizioni della gestione basata su criteri.

Nota importanteImportante

Le funzioni che è possibile utilizzare per creare le condizioni della gestione basata su criteri non utilizzano sempre la sintassi Transact-SQL. Verificare di seguire la sintassi di esempio. Quando si utilizza la funzione DateAdd o DatePart, è necessario ad esempio racchiudere l'argomento datepart tra virgolette singole.

Funzione

Descrizione

Add()

Firma della funzione: Numeric Add (Numeric expression1, Numeric expression2)

Descrizione della funzione: somma due numeri.

Argomenti:

  • expression1 e expression2 - Qualsiasi espressione valida di un qualsiasi tipo di dati della categoria numerica, ad eccezione del tipo di dati bit. Può essere una costante, una proprietà o una funzione che restituisce un tipo numerico.

Valore restituito: tipo di dati dell'argomento con la priorità più alta.

Esempio: Add(Property1, 5)

Array()

Firma della funzione: Array Array (VarArgs expression)

Descrizione della funzione: crea una matrice da un elenco di valori. Può essere utilizzata con funzioni di aggregazione, ad esempio Sum() e Count().

Argomenti:

  • expression - Espressione che verrà convertita in matrice.

Valore restituito: matrice.

Esempio: Array(2,3,4,5,6)

Avg()

Firma della funzione: Numeric Avg (VarArgs)

Descrizione della funzione: restituisce la media di tutti i valori nell'elenco di argomenti.

Argomenti:

  • VarArgs - Elenco di espressioni Variant della categoria di tipi di dati numerici esatti o numerici approssimativi, ad eccezione del tipo di dati bit.

Valore restituito: il tipo restituito è determinato dal tipo del risultato valutato dell'espressione.

Se il risultato dell'espressione appartiene alle categorie integer, decimal, money e smallmoney, float e real, i tipi restituiti sono rispettivamente int, decimal, money e float.

Esempio: Avg(1.0, 2.0, 3.0, 4.0, 5.0) restituisce 3.0 in questo esempio.

BitwiseAnd()

Firma della funzione: Numeric BitwiseAnd (Numeric expression 1, Numeric expression2)

Descrizione della funzione: esegue un'operazione con AND logico bit per bit tra due valori interi.

Argomenti:

  • expression1 e expression2 - Qualsiasi espressione valida di un qualsiasi tipo di dati della categoria di tipi di dati integer.

Valore restituito: valore della categoria di tipi di dati integer.

Esempio: BitwiseAnd(Property1, Property2)

BitwiseOr()

Firma della funzione: Numeric BitwiseOr (Numeric expression1, Numeric expression2)

Descrizione della funzione: esegue un'operazione con OR logico bit per bit tra due valori interi specificati.

Argomenti:

  • expression1 e expression2 - Qualsiasi espressione valida di un qualsiasi tipo di dati della categoria di tipi di dati integer.

Valore restituito: valore della categoria di tipi di dati integer.

Esempio: BitwiseOr(Property1, Property2)

Concatenate()

Firma della funzione: String Concatenate (String string1, String string2)

Descrizione della funzione: concatena due stringhe.

Argomenti:

  • string1 e string2: le due stringhe da concatenare che possono essere costituite da qualsiasi stringa non Null valida.

Valore restituito: stringa concatenata in cui string1 è seguita da string2.

Esempio: Concatenate("Hello", " World") restituisce "Hello World".

Count()

Firma della funzione: Numeric Count (VarArgs)

Descrizione della funzione: restituisce il numero di elementi nell'elenco di argomenti.

Argomenti:

  • VarArgs - Espressione di qualsiasi tipo, ad eccezione di text, image e ntext.

Valore restituito: valore della categoria di tipi di dati integer.

Esempio: Count(1.0, 2.0, 3.0, 4.0, 5.0) restituisce 5 in questo esempio.

DateAdd()

Firma della funzione: DateTime DateAdd (String datepart, Numeric number, DateTime date)

Descrizione della funzione: restituisce un nuovo valore datetime basato sull'aggiunta di un intervallo alla data specificata.

Argomenti:

  • datepart - Parametro che specifica in quale parte della data restituire un nuovo valore. I tipi supportati includono year(yy, yyyy), month(mm, m) e dayofyear(dy, y). Per ulteriori informazioni, vedere DATEADD (Transact-SQL).

  • number - Valore utilizzato per incrementare datepart.

  • date - Espressione che restituisce un valore datetime o una stringa di caratteri in formato data.

Valore restituito: nuovo valore di datetime, basato sull'aggiunta di un intervallo alla data specificata.

Esempio: DateAdd('day', 21, DateTime('2007-08-06 14:21:50')) restituisce '2007-08-27 14:21:50' in questo esempio.

Nella tabella seguente sono elencati i valori di dateparts e le abbreviazioni supportate da questa funzione.

Datepart

Abbreviazioni

year

yy, yyyy

month

mm, m

dayofyear

dy, y

day

dd, d

week

wk, ww

giorno feriale

dw, w

hour

hh

minute

mi, n

second

ss, s

millisecond

ms

DatePart()

Firma della funzione: Numeric DatePart (String datepart, DateTime date)

Descrizione della funzione: restituisce un valore intero che rappresenta il valore datepart specificato della data specificata.

Argomenti:

  • datepart- Parametro che specifica la parte della data da restituire. I tipi supportati includono year(yy, yyyy), month(mm, m) e dayofyear(dy, y). Per ulteriori informazioni, vedere DATEPART (Transact-SQL).

  • date - Espressione che restituisce un valore datetime o una stringa di caratteri in formato data.

Valore restituito: valore di una categoria di tipi di dati integer che rappresenta il valore datepart specificato della data indicata.

Esempio: DatePart('month', DateTime('2007-08-06 14:21:50.620')) restituisce 8 in questo esempio.

DateTime()

Firma della funzione: DateTime DateTime (String dateString)

Descrizione della funzione: crea un valore datetime da una stringa.

Argomenti:

  • dateString - Valore datetime come stringa.

Valore restituito: valore datetime creato dalla stringa di input.

Esempio: DateTime('3/12/2006')

Divide()

Firma della funzione: Numeric Divide (Numeric expression_dividend, Numeric expression_divisor)

Descrizione della funzione: divide un numero per un altro.

Argomenti:

  • expression_dividend- Espressione numerica da dividere. Il dividendo può essere qualsiasi espressione valida di un qualsiasi tipo di dati della categoria di tipi di dati numerici, ad eccezione del tipo di dati datetime.

  • expression_divisor - Espressione numerica per cui dividere il dividendo. Il divisore può essere qualsiasi espressione valida di un qualsiasi tipo di dati della categoria di tipi di dati numerici, ad eccezione del tipo di dati datetime.

Valore restituito: tipo di dati dell'argomento con la priorità più alta.

Esempio: Divide(Property1, 2)

[!NOTA]

Si tratta di una doppia operazione. Per eseguire un confronto tra integer, è necessario combinare i risultati con Round(), ad esempio: Round(Divide(10, 3), 0) = 3.

Enum()

Firma della funzione: Numeric Enum (String enumTypeName, String enumValueName)

Descrizione della funzione: crea un valore di enumerazione da una stringa.

Argomenti:

  • enumTypeName: nome del tipo di enumerazione.

  • enumValueName: valore dell'enumerazione.

Valore restituito: valore di enumerazione come valore numerico.

Esempio: Enum('CompatibilityLevel','Version100')

Escape()

Firma della funzione: String Escape (String replaceString, String stringToEscape, String escapeString)

Descrizione della funzione: trasferisce una sottostringa della stringa di input con una stringa di escape specificata.

Argomenti:

  • replaceString: stringa di input.

  • stringToEscape: sottostringa di replaceString. Si tratta della stringa davanti alla quale si desidera aggiungere una stringa di escape.

  • escapeString: stringa di escape che si desidera aggiungere davanti a ogni istanza di stringToEscape.

Valore restituito: stringa replaceString modificata in cui ogni istanza di stringToEscape è preceduta da escapeString.

Esempio: Escape("Hello", "l", "[") restituisce "He[l[lo".

ExecuteSQL()

Firma della funzione: Variant ExecuteSQL (String returnType, String sqlQuery)

Descrizione della funzione: esegue la query Transact-SQL sul server di destinazione.

Argomenti:

  • returnType - Specifica il tipo restituito dei dati restituiti dall'istruzione Transact-SQL. I valori letterali validi per returnType sono i seguenti: Numeric, String, Bool, DateTime, Array e Guid.

  • sqlQuery - Stringa che contiene la query da eseguire.

Esempio: ExecuteSQL ('Numeric', 'SELECT COUNT(*) FROM msdb.dbo.sysjobs') <> 0

Esegue una query Transact-SQL con valori scalari su un'istanza di destinazione di SQL Server. È possibile specificare una sola colonna in un'istruzione SELECT. Le colonne aggiuntive oltre la prima vengono ignorate. La query risultante deve restituire una sola riga. Le righe aggiuntive oltre la prima vengono ignorate. Se la query restituisce un set vuoto, l'espressione della condizione compilata in base a ExecuteSQL restituirà false. ExecuteSql supporta le modalità di valutazione Su richiesta e Su pianificazione.

  • @@ObjectName - Corrisponde al campo del nome in sys.objects. La variabile verrà sostituita con il nome dell'oggetto corrente.

  • @@ObjectSchema - Corrisponde al campo del nome in sys.schemas. La variabile verrà sostituita con il nome dello schema per l'oggetto corrente, se applicabile.

[!NOTA]

Per includere una virgoletta singola in un'istruzione ExecuteSQL, trasformarla in una sequenza di escape con una seconda virgoletta singola. Ad esempio, per includere un riferimento a un utente di nome O'Brian, digitare O"Brian.

ExecuteWQL()

Firma della funzione: Variant ExecuteWQL (string returnType , string namespace, string wql)

Descrizione della funzione: esegue lo script WQL in base allo spazio dei nomi specificato. L'istruzione Select può contenere solo una singola colonna restituita. Se vengono specificate più colonne, verrà generato un errore.

Argomenti e definizione dei tipi restituiti

  • returnType - Specifica il tipo restituito dei dati restituiti dall'istruzione WQL. I valori letterali validi sono Numeric, String, Bool, DateTime, Array e Guid.

  • namespace - Spazio dei nomi WMI su cui eseguire la funzione.

  • wql - Stringa che contiene la funzione WQL da eseguire.

Esempio: ExecuteWQL('Numeric', 'root\CIMV2', 'select NumberOfProcessors from win32_ComputerSystem') <> 0

False()

Firma della funzione: Bool False()

Descrizione della funzione: restituisce il valore booleano FALSE.

Valore restituito: valore booleano FALSE.

Esempio: IsDatabaseMailEnabled = False()

GetDate()

Firma della funzione: DateTime GetDate()

Descrizione della funzione: restituisce la data di sistema.

Valore restituito: data di sistema come valore DateTime.

Esempio: @DateLastModified = GetDate()

Guid()

Firma della funzione: Guid Guid(String guidString)

Descrizione della funzione: restituisce un GUID da una stringa.

Argomenti:

  • guidString- Rappresentazione stringa del GUID da creare.

Valore restituito: GUID creato dalla stringa.

Esempio: Guid('12340000-0000-3455-0000-000000000454')

IsNull()

Firma della funzione: Variant IsNull (Variant check_expression, Variant replacement_value)

Descrizione della funzione: viene restituito il valore di check_expression se non è NULL. In caso contrario, viene restituito replacement_value. Se i tipi sono diversi, replacement_value viene convertito in modo implicito nel tipo di check_expression.

Argomenti:

  • check_expression - È l'espressione da verificare per determinare se è NULL. check_expression può essere uno dei tipi supportati dalla gestione basata su criteri: Numeric, String, Bool, DateTime, Array e Guid.

  • replacement_value - È l'espressione da restituire se check_expression è NULL. replacement_value deve essere di un tipo che può essere convertito in modo implicito nel tipo di check_expression.

Valore restituito: tipo di check_expression se check_expression non è NULL. In caso contrario, viene restituito il tipo di replacement_value.

Len()

Firma della funzione: Numeric Len (string_expression)

Descrizione della funzione: restituisce il numero di caratteri dell'espressione stringa specificata, esclusi gli spazi vuoti finali.

Argomenti:

  • string_expression - Espressione stringa da valutare.

Valore restituito: valore della categoria di tipi di dati integer.

Esempio: Len('Hello') restituisce 5 in questo esempio.

Lower()

Firma della funzione: String Lower (String_expression)

Descrizione della funzione: restituisce la stringa dopo avere convertito tutti i caratteri maiuscoli in minuscoli.

Argomenti:

  • expression - Espressione della stringa di origine.

Valore restituito: stringa che rappresenta l'espressione della stringa di origine dopo che tutti i caratteri maiuscoli vengono convertiti in minuscoli.

Esempio: Len('HeLlO') restituisce 'hello' in questo esempio.

Mod()

Firma della funzione: Numeric Mod (Numeric expression_dividend, Numeric expression_divisor)

Descrizione della funzione: restituisce il resto integer dopo aver diviso la prima espressione numerica per la seconda.

Argomenti:

  • expression_dividend- Espressione numerica da dividere. expression_dividend deve essere un'espressione valida di uno dei tipi di dati nell'Integer o nelle categorie di tipi di dati numerici.

  • expression_divisor - È l'espressione numerica per cui dividere il dividendo. expression_divisor deve essere un'espressione valida di uno dei tipi di dati nell'Integer o nelle categorie di tipi di dati numerici.

Valore restituito: valore della categoria di tipi di dati integer.

Esempio: Mod(Property1, 3)

Multiply()

Firma della funzione: Numeric Multiply (Numeric expression1, Numeric expression2)

Descrizione della funzione: moltiplica due espressioni.

Argomenti:

  • expression1 e expression2 - Qualsiasi espressione valida di un qualsiasi tipo di dati della categoria numerica, ad eccezione del tipo di dati datetime.

Valore restituito: tipo di dati dell'argomento con la priorità più alta.

Esempio: Multiply(Property1, .20)

Power()

Firma della funzione: Numeric Power (Numeric numeric_expression, Numeric expression_power)

Descrizione della funzione: restituisce il valore dell'espressione specificata elevato alla potenza specificata.

Argomenti:

  • numeric_expression - Espressione della categoria di tipi di dati numerici esatti o numerici approssimativi, ad eccezione del tipo di dati bit.

  • expression_power- Potenza alla quale generare numeric_expression. expression_power può essere un'espressione della categoria di tipi di dati numerici esatti o approssimati, ad eccezione del tipo di dati bit.

Valore restituito: il tipo restituito è identico a numeric_expression.

Esempio: Power(Property1, 3)

Round()

Firma della funzione: Numeric Round (Numeric expression, Numeric expression_precision)

Descrizione della funzione: restituisce un'espressione numerica arrotondata alla lunghezza o alla precisione specificata.

Argomenti:

  • expression - Espressione della categoria di tipi di dati numerici esatti o numerici approssimati, ad eccezione del tipo di dati bit.

  • expression_precision - Precisione a cui arrotondare l'espressione. Quando expression_precision è un numero positivo, numeric_expression viene arrotondata al numero di posizioni decimali specificato da length. Quando expression_precision è un numero negativo, numeric_expression viene arrotondata a sinistra del separatore decimale, come specificato da expression_precision.

Valore restituito: restituisce lo stesso tipo di numeric_expression.

Esempio: Round(5.333, 0)

String()

Firma della funzione: String String (Variant_expression)

Descrizione della funzione: converte un tipo di dati Variant in una stringa.

Argomenti:

  • expression- Espressione Variant da convertire in stringa.

Valore restituito: valore stringa dell'espressione Variant.

Esempio: String(4)

Sum()

Firma della funzione: Numeric Sum (VarArgs)

Descrizione della funzione: restituisce la somma di tutti i valori nell'elenco di argomenti. È possibile utilizzare Sum con valori numerici.

Argomenti:

  • VarArgs - Elenco di espressioni Variant della categoria di tipi di dati numerici esatti o numerici approssimativi, ad eccezione del tipo di dati bit.

Valore restituito: restituisce la somma di tutti i valori dell'espressione nel tipo di dati di espressione più preciso.

Se il risultato dell'espressione appartiene alle categorie integer, numeric, money e small money, float e real, i tipi restituiti sono rispettivamente int, numeric, money e float.

Esempio: Sum(1.0, 2.0, 3.0, 4.0, 5.0) restituisce 15 in questo esempio.

True()

Firma della funzione: Bool TRUE()

Descrizione della funzione: restituisce il valore booleano TRUE.

Valore restituito: valore booleano TRUE.

Esempio: IsDatabaseMailEnabled = True()

Upper()

Firma della funzione: String Upper (String_expression)

Descrizione della funzione: restituisce la stringa dopo avere convertito tutti i caratteri minuscoli in maiuscoli.

Argomenti:

  • expression - Espressione della stringa di origine.

Valore restituito: restituisce una stringa che rappresenta l'espressione della stringa di origine dopo che tutti i caratteri minuscoli vengono convertiti in maiuscoli.

Esempio: Len('HeLlO') restituisce 'HELLO' in questo esempio.

Vedere anche

Riferimento

Finestra di dialogo Crea nuova condizione o Apri condizione, pagina Generale

Concetti

Amministrazione di server tramite la gestione basata su criteri