Sdílet prostřednictvím

Odstranění a obnovení objektu blob pomocí Javy

  • Článek

Tento článek ukazuje, jak odstranit objekty blob pomocí klientské knihovny Azure Storage pro Javu. Pokud jste povolili obnovitelné odstranění objektů blob, můžete odstraněné objekty blob obnovit během doby uchovávání.

Požadavky

  • Tento článek předpokládá, že už máte projekt nastavený tak, aby fungoval s klientskou knihovnou služby Azure Blob Storage pro Javu. Další informace o nastavení projektu, včetně instalace balíčku, přidání import direktiv a vytvoření autorizovaného objektu klienta, najdete v tématu Začínáme se službou Azure Storage a Javou.
  • Autorizační mechanismus musí mít oprávnění k odstranění objektu blob nebo obnovení obnovitelně odstraněného objektu blob. Další informace najdete v pokynech k autorizaci pro následující operace rozhraní REST API:

Odstranění objektu blob

Pokud chcete odstranit objekt blob, zavolejte jednu z těchto metod:

Následující příklad odstraní objekt blob:

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

Pokud objekt blob obsahuje nějaké přidružené snímky, musíte odstranit všechny jeho snímky, abyste objekt blob odstranili. Následující příklad odstraní objekt blob a jeho snímky s odpovědí:

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());
    }
}

Pokud chcete odstranit pouze snímky a ne samotný objekt blob, můžete předat parametr DeleteSnapshotsOptionType.ONLY.

Obnovení odstraněného objektu blob

Obnovitelné odstranění objektu blob chrání jednotlivý blob a jeho verze, snímky a metadata před náhodným odstraněním nebo přepsáním tak, že odstraněná data se po určitou dobu uchovají v systému. Během doby uchovávání můžete blob obnovit do stavu v době jeho odstranění. Po uplynutí doby uchovávání se objekt blob odstraní trvale. Další informace o obnovitelném odstranění objektů blob najdete v tématu Obnovitelné odstranění objektů blob.

Klientské knihovny Azure Storage můžete použít k obnovení obnovitelně odstraněného objektu blob nebo snímku.

Obnovení obnovitelně odstraněného objektu blob závisí na tom, jestli má váš účet úložiště povolenou správu verzí objektů blob. Další informace o správě verzí objektů blob najdete v tématu Správa verzí objektů blob. V závislosti na vašem scénáři si projděte jednu z následujících částí:

Obnovení obnovitelně odstraněných objektů při zakázání správy verzí

Pokud chcete obnovit odstraněné objekty blob, zavolejte následující metodu:

Tato metoda obnoví obsah a metadata obnovitelně odstraněného objektu blob a všechny přidružené obnovitelné odstraněné snímky. Volání této metody pro objekt blob, který nebyl odstraněn, nemá žádný vliv.

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

Obnovení obnovitelně odstraněných objektů při povolení správy verzí

Pokud je účet úložiště nakonfigurovaný tak, aby umožňoval správu verzí objektů blob, odstranění objektu blob způsobí, že aktuální verze objektu blob se stane předchozí verzí. Pokud chcete obnovit obnovit obnovitelně odstraněný objekt blob při povolení správy verzí, zkopírujte předchozí verzi nad základní objekt blob. Můžete použít následující metodu:

Tato metoda obnoví obsah a metadata obnovitelně odstraněného objektu blob a všechny přidružené obnovitelné odstraněné snímky. Volání této metody pro objekt blob, který nebyl odstraněn, nemá žádný vliv.

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());
}

Obnovení obnovitelně odstraněných objektů blob a adresářů (hierarchický obor názvů)

Důležité

Tato část se vztahuje pouze na účty, které mají hierarchický obor názvů.

  1. Začněte tím, že otevřete soubor pom.xml v textovém editoru. Do skupiny závislostí přidejte následující prvek závislosti.

    <dependency>
  <groupId>com.azure</groupId>
  <artifactId>azure-storage-file-datalake</artifactId>
  <version>12.6.0</version>
</dependency>

  2. Pak tyto příkazy importu přidejte do souboru kódu.

    Put imports here

  3. Následující fragment kódu obnoví obnovitelně odstraněný soubor s názvem my-file.

    Tato metoda předpokládá, že jste vytvořili instanci DataLakeServiceClient . Informace o vytvoření instance DataLakeServiceClient najdete v tématu Připojení k účtu.

    
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);
 }

    Pokud přejmenujete adresář obsahující obnovitelné odstraněné položky, tyto položky se od adresáře odpojí. Pokud chcete tyto položky obnovit, budete muset vrátit název adresáře zpět k původnímu názvu nebo vytvořit samostatný adresář, který používá původní název adresáře. Jinak se při pokusu o obnovení těchto obnovitelně odstraněných položek zobrazí chyba.

Zdroje informací

Další informace o tom, jak odstranit objekty blob a obnovit odstraněné objekty blob pomocí klientské knihovny služby Azure Blob Storage pro Javu, najdete v následujících zdrojích informací.

Operace rozhraní REST API

Sada Azure SDK pro Javu obsahuje knihovny, které jsou postavené na rozhraní Azure REST API a umožňují interakci s operacemi rozhraní REST API prostřednictvím známých paradigmat Javy. Metody klientské knihovny pro odstranění objektů blob a obnovení odstraněných objektů blob používají následující operace rozhraní REST API:

Ukázky kódu

Prostředky klientské knihovny

Viz také