Condividi tramite


Eliminare e ripristinare un BLOB con Java

Questo articolo illustra come eliminare i BLOB con la libreria client di Archiviazione di Azure per Java. Se è stata abilitata l'eliminazione temporanea per i BLOB, è possibile ripristinare i BLOB eliminati durante il periodo di conservazione.

Prerequisiti

  • Questo articolo presuppone che sia già stato configurato un progetto per l'uso con la libreria client di Archiviazione BLOB di Azure per Java. Per informazioni sulla configurazione del progetto, incluse l'installazione del pacchetto, l'aggiunta di direttive import e la creazione di un oggetto client autorizzato, vedere Introduzione ad Archiviazione di Azure e Java.
  • Il meccanismo di autorizzazione deve disporre delle autorizzazioni per eliminare un BLOB o per ripristinare un BLOB eliminato temporaneamente. Per altre informazioni, vedere le linee guida per l'autorizzazione per le operazioni API REST seguenti:

Eliminare un BLOB

Per eliminare un BLOB, chiamare uno di questi metodi:

Nell'esempio seguente viene eliminato un oggetto BLOB:

public void deleteBlob(BlobClient blobClient) {
    blobClient.delete();
}

Se il BLOB presenta snapshot associati, è necessario eliminare tutti gli snapshot per eliminare il BLOB. Nell'esempio seguente viene eliminato un BLOB e i relativi snapshot con una risposta:

public void deleteBlobWithSnapshots(BlobClient blobClient) {
    Response<Boolean> response = blobClient.deleteIfExistsWithResponse(DeleteSnapshotsOptionType.INCLUDE, null,
            null,
            new Context("key", "value"));
    if (response.getStatusCode() == 404) {
        System.out.println("Blob does not exist");
    } else {
        System.out.printf("Delete blob completed with status %d%n", response.getStatusCode());
    }
}

Per eliminare solo gli snapshot e non il BLOB stesso, è possibile passare il parametro DeleteSnapshotsOptionType.ONLY.

Ripristinare un BLOB eliminato

L'eliminazione temporanea dei BLOB protegge un singolo BLOB con le sue versioni, gli snapshot e i metadati da eliminazioni o sovrascritture accidentali, mantenendo i dati eliminati nel sistema per un periodo di tempo specificato. Durante il periodo di conservazione è possibile ripristinare il BLOB nello stato in cui era al momento dell'eliminazione. Dopo la scadenza del periodo di conservazione, il BLOB viene eliminato definitivamente. Per altre informazioni sull'eliminazione temporanea dei BLOB, vedere Eliminazione temporanea per i BLOB.

È possibile usare le librerie client di Archiviazione di Azure per ripristinare un BLOB o uno snapshot eliminato temporaneamente.

La modalità di ripristino di un BLOB eliminato temporaneamente dipende dal fatto che l'account di archiviazione disponga o meno del controllo delle versioni per i BLOB abilitato. Per altre informazioni sul controllo delle versioni dei BLOB, vedere Controllo delle versioni per i BLOB. Passare a una delle sezioni seguenti in base allo scenario:

Ripristinare gli oggetti eliminati temporaneamente quando il controllo delle versioni è disabilitato

Per ripristinare i BLOB eliminati, chiamare il metodo seguente:

Questo metodo ripristina il contenuto e i metadati di un BLOB eliminato temporaneamente e di eventuali snapshot eliminati temporaneamente associati. Chiamare questo metodo per un BLOB che non è stato eliminato non ha alcun effetto.

public void restoreBlob(BlobClient blobClient) {
    blobClient.undelete();
}

Ripristinare gli oggetti eliminati temporaneamente quando è abilitato il controllo delle versioni

Se un account di archiviazione è configurato per abilitare il controllo delle versioni dei BLOB, l'eliminazione di un BLOB fa sì che la versione corrente del BLOB diventi la versione precedente. Per ripristinare un BLOB eliminato temporaneamente quando è abilitato il controllo delle versioni, copiare una versione precedente sul BLOB di base. È possibile usare il metodo seguente:

Questo metodo ripristina il contenuto e i metadati di un BLOB eliminato temporaneamente e di eventuali snapshot eliminati temporaneamente associati. Chiamare questo metodo per un BLOB che non è stato eliminato non ha alcun effetto.

public void restoreBlobVersion(BlobContainerClient containerClient, BlobClient blobClient){
    // List blobs in this container that match the prefix
    // Include versions in the listing
    ListBlobsOptions options = new ListBlobsOptions()
            .setPrefix(blobClient.getBlobName())
            .setDetails(new BlobListDetails()
                    .setRetrieveVersions(true));
    Iterator<BlobItem> blobItem = containerClient.listBlobs(options, null).iterator();
    List<String> blobVersions = new ArrayList<>();
    while (blobItem.hasNext()) {
        blobVersions.add(blobItem.next().getVersionId());
    }

    // Sort the list of blob versions and get the most recent version ID
    Collections.sort(blobVersions, Collections.reverseOrder());
    String latestVersion = blobVersions.get(0);

    // Get a client object with the name of the deleted blob and the specified version
    BlobClient blob = containerClient.getBlobVersionClient("sampleBlob.txt", latestVersion);

    // Restore the most recent version by copying it to the base blob
    blobClient.copyFromUrl(blob.getBlobUrl());
}

Ripristinare BLOB e directory eliminati temporaneamente (spazio dei nomi gerarchico)

Importante

Questa sezione si applica solo agli account con uno spazio dei nomi gerarchico.

  1. Per iniziare, aprire il file pom.xml nell'editor di testo. Aggiungere l'elemento di dipendenza seguente al gruppo di dipendenze.

    <dependency>
      <groupId>com.azure</groupId>
      <artifactId>azure-storage-file-datalake</artifactId>
      <version>12.6.0</version>
    </dependency>
    
  2. Aggiungere quindi queste istruzioni importanti al file di codice.

    Put imports here
    
  3. Il frammento di codice seguente ripristina un file eliminato temporaneamente denominato my-file.

    Questo metodo presuppone che sia stata creata un'istanza DataLakeServiceClient. Per informazioni su come creare un'istanza DataLakeServiceClient, vedere Connettersi all'account.

    
    public void RestoreFile(DataLakeServiceClient serviceClient){
    
        DataLakeFileSystemClient fileSystemClient =
            serviceClient.getFileSystemClient("my-container");
    
        DataLakeFileClient fileClient =
            fileSystemClient.getFileClient("my-file");
    
        String deletionId = null;
    
        for (PathDeletedItem item : fileSystemClient.listDeletedPaths()) {
    
            if (item.getName().equals(fileClient.getFilePath())) {
               deletionId = item.getDeletionId();
            }
        }
    
        fileSystemClient.restorePath(fileClient.getFilePath(), deletionId);
     }
    
    

    Se si rinomina la directory che contiene gli elementi eliminati temporaneamente, tali elementi vengono disconnessi dalla directory. Se si vogliono ripristinare tali elementi, sarà necessario ripristinare il nome originale della directory o creare una directory separata che usa il nome della directory originale. In caso contrario, quando si tenta di ripristinare gli elementi eliminati temporaneamente si riceve un errore.

Risorse

Per altre informazioni su come eliminare i BLOB e ripristinare i BLOB eliminati usando la libreria client di Archiviazione BLOB di Azure per Java, vedere le risorse seguenti.

Operazioni dell'API REST

Azure SDK per Java contiene librerie basate sull'API REST di Azure, che consentono di interagire con le operazioni dell'API REST tramite paradigmi Java noti. I metodi della libreria client per eliminare i BLOB e ripristinare i BLOB eliminati fanno uso delle operazioni API REST seguenti:

Esempi di codice

Risorse della libreria client

Vedi anche