Voorwaarden voor opslagtaken

Een opslagtaak specificeert de voorwaarden die geëvalueerd moeten worden en de bewerkingen die op blobs moeten worden uitgevoerd. In dit artikel wordt de JSON-indeling van een voorwaarde beschreven. Dit formaat is belangrijk als je van plan bent een opslagtaak te maken met een ander hulpmiddel dan het Azure-portaal, zoals Azure PowerShell of Azure CLI. Dit artikel somt ook de eigenschappen en operatoren op die je kunt gebruiken in de clausules van een conditie.

Dit artikel is gericht op voorwaarden. Zie Storage-taakbewerkingen voor meer informatie over bewerkingen.

Opmaak van voorwaarde

Een voorwaarde is een logisch predicaat dat bestaat uit één of meer clausules. Elke clausule bevat een blob-eigenschap, een logische operator en een waarde. Wanneer de opslagtaak wordt uitgevoerd, vergelijkt deze de blob-eigenschap met de waarde met behulp van de vergelijkingsoperator. In het JSON-formaat verschijnt de operator altijd eerst, gevolgd door de eigenschap, en daarna de waarde. In de volgende afbeelding ziet u hoe elk element in de expressie wordt weergegeven.

Diagram met de indeling van een eenvoudige voorwaarde met een operator, eigenschap en waarde.

Met de volgende component kunnen bewerkingen alleen worden uitgevoerd op Microsoft Word-documenten. Deze component is gericht op alle documenten die eindigen op de bestandsextensie .docx. Daarom is de operator endsWith, de eigenschap Name, en de waarde .docx.

{
   "condition": "[[[endsWith(Name, '.docx')]]"
}

U kunt ook een niet-operator toepassen vóór de operator in een voorwaardecomponent. De niet operator is een speciale operator die je vóór elke andere operator kunt plaatsen om het tegenovergestelde resultaat van een zinsdeel te krijgen. Met de volgende component kunt u bewerkingen uitvoeren op een blob die geen Microsoft Word-document is .

{
   "condition": "[[not(endsWith(Name, '*.docx'))]]"
}

Voor de volledige lijst van operatoren en eigenschapsnamen, zie de secties Ondersteunde operatoren en Ondersteunde eigenschappen van dit artikel.

Meerdere componenten in een voorwaarde

Een voorwaarde kan meerdere componenten bevatten, gescheiden door een komma, samen met de tekenreeks and of or. De tekenreeks and is van toepassing op objecten die voldoen aan alle criteria in de afzonderlijke onderdelen van de voorwaarde, terwijl or van toepassing is op objecten die voldoen aan een van de criteria in een van de onderdelen van de voorwaarde. In de volgende afbeelding ziet u de positie van de tekenreeksen and en or, samen met twee clausules.

Diagram met de indeling van een voorwaarde die twee componenten bevat.

In de volgende JSON ziet u een voorwaarde die twee componenten bevat. Omdat de and tekenreeks in deze expressie wordt gebruikt, moeten beide voorwaarden true evalueren voordat een bewerking op het object wordt uitgevoerd.

{
"condition": "[[and(endsWith(Name, '.docx'), equals(Tags.Value[readyForLegalHold], 'Yes'))]]"
}

Groepen voorwaarden

Gegroepeerde componenten werken als één eenheid, gescheiden van de rest van de componenten. Groeperingsclausules zijn vergelijkbaar met het plaatsen van haakjes rond een wiskundige vergelijking of logische expressie. De and of or tekenreeks voor de eerste component in de groep is van toepassing op de hele groep.

In de volgende afbeelding ziet u twee zinnen samengevoegd.

Diagram met de indeling van een voorwaarde die twee componenten bevat die zijn gegroepeerd.

Met de volgende voorwaarde kunnen bewerkingen alleen worden uitgevoerd op Microsoft Word-documenten waarvan de readyForLegalHold tag van het document is ingesteld op een waarde van Yes. Bewerkingen worden ook uitgevoerd op objecten die groter zijn dan 100 bytes, zelfs als de andere twee voorwaarden niet waar zijn.

{
"condition": "[[or(and(endsWith(Name, '*.docx'), equals(Tags.Value[readyForLegalHold], 'Yes')), greater(Content-Length, '100'))]]"
}

U kunt een niet-operator toepassen op een groep om te testen op het tegenovergestelde resultaat van een groep componenten. Met de volgende voorwaarde kunnen bewerkingen alleen worden uitgevoerd op blobs die geen Microsoft Word-documenten zijn waarbij de readyForLegalHold tag van de blob is ingesteld op een waarde van Yes. Bewerkingen worden ook uitgevoerd op objecten die groter zijn dan 100 bytes, zelfs als de andere twee voorwaarden niet waar zijn.

{
"condition": "[[or(not(and(endsWith(Name, '*.docx'), equals(Tags.Value[readyForLegalHold], 'Yes'))), greater(Content-Length, '100'))]]"
}

Codeweergave in Azure Portal

Gebruik de visuele editor in het Azure-portaal om de JSON voor een voorwaarde te genereren en open vervolgens de JSON-expressie door het tabblad Code te selecteren. Deze aanpak is handig bij het samenstellen van complexe condities, omdat JSON-expressies groot, onhandig en moeilijk handmatig te maken kunnen worden. Met deze aanpak kun je ook de conditiepreviewfunctie in het portaal gebruiken voor interactieve validatie van de conditie aan de hand van je gegevens. In de volgende afbeelding ziet u het tabblad Code in de visuele editor.

Schermopname van de JSON-voorwaarde zoals deze wordt weergegeven op het tabblad Code van de visualontwerper.

Voor meer informatie over de visuele editor, zie Voorwaarden en bewerkingen voor opslagtaken definiëren.

Voorvertoning van voorwaarde

De functie Voorwaarde vooraf bekijken stelt je in staat de conditie te valideren tegen blobs in je testopslagaccount en te zien of ze wel of niet voldoen aan de door jou gedefinieerde voorwaarden. Je kunt problemen vinden en condities optimaliseren voordat je ze toepast op productiedata. De preview verandert geen objecten in een doelopslagaccount, dus het is veilig om het te testen met je data.

Hoewel preview van voorwaarden beschikbaar is in PowerShell-, Azure CLI- en SDK-omgevingen, is de eenvoudigste manier om een voorbeeld van het effect van voorwaarden te bekijken met behulp van het venster Preview-voorwaarden in Azure Portal. Je kunt dit venster openen wanneer je voorwaarden definieert en opslagtaken toewijst.

Als u een voorbeeld van het effect van voorwaarden wilt bekijken, moet u een doelabonnement, opslagaccount en container opgeven. Omdat een preview slechts tot 5.000 blobs kan tonen, kun je ook een prefix specificeren om de lijst te versmallen.

Opmerking

U kunt geen jokertekens gebruiken in het blobvoorvoegsel.

In de volgende afbeelding ziet u een voorbeeld van een voorbeeldresultaat in Azure Portal.

Schermopname van het voorbeeldvenster voor opslagtaken in Azure Portal.

Het previewresultaat verschijnt in een tabel van alle objecten in de geselecteerde container met het resultaat van de conditie-evaluatie en hun eigenschappenwaarden die zijn gebruikt om de conditie te evalueren. Je kunt sorteren op elk veld dat in de tabel verschijnt.

Als voorwaarden verwijzen naar eigenschappen die niet bestaan in het doelopslagaccount, wordt er een fout weergegeven. Blob-indextags zijn bijvoorbeeld niet beschikbaar voor accounts met een hiërarchische naamruimte. Als een component in een voorwaarde verwijst naar blobindextags, wordt er een validatiefout weergegeven.

Ondersteunde eigenschappen

In de volgende tabel ziet u de eigenschappen die u kunt gebruiken om elke component van een voorwaarde samen te stellen. Een component kan tekenreeks-, booleaanse, numerieke en datum- en tijdeigenschappen bevatten.

Snaar / Touwtje Datum en tijd3 Numeriek Booleaan
AccessTier1 ToegangsniveauVeranderingstijd Lengte van inhoud Verwijderd
BlobType2 Aanmaaktijd TagCount IsRecenteVersie
Container.Metadata.Value[Naam] VerwijderdeTijd
Container.Naam LaatsteToegangstijd
Metadata.Value[Name] Laatst gewijzigd
Naam
Tags.Value[Naam]

1 Toegestane waarden zijn Hot, Cool, Cold, of Archive.

2 Toegestane waarden zijn BlockBlob, PageBlob, of AppendBlob.

3 Kan worden ingesteld op een specifieke tijd of op een metagegevenswaarde die dynamisch wordt verkregen van objecten. Zie Verwijzen naar een waarde uit objectmetagegevens.

Ondersteunde operators

In de volgende tabel ziet u de operators die u in een clausule kunt gebruiken om de waarde van elk type eigenschap te beoordelen.

String (niet-hoofdlettergevoelig) String (hoofdlettergevoelig) Datum en tijd Numeriek Booleaan
contains contains_cs equals equals equals
empty 5 greater greater
endsWith endsWith_cs greaterOrEquals greaterOrEquals
equals equals_cs less less
matches 4 matches_cs 4 lessOrEquals lessOrEquals
startsWith startsWith_cs

4 De matches en matches_cs operators worden niet ondersteund voor Metadata.Value[Name] en Tags.Value[Name] eigenschappen.

5 De empty operator test of een waarde leeg is. Hoofdlettergevoeligheid geldt niet, en er is geen empty_cs operator.

De not-operator is een speciale operator die je vóór elk van de operatoren in deze tabel kunt positioneren om het resultaat van een conditionele clausule, ook wel het negatieve resultaat genoemd, om te keren.

Stringoperatoren met het achtervoegsel _cs zijn hoofdlettergevoelig. Bijvoorbeeld, endsWith(Name, '.CSV') matcht zowel report.CSV als report.csv, terwijl endsWith_cs(Name, '.CSV') alleen met report.CSV overeenkomt.

Zie ook