Organisieren von Objekten mit Präfixen

Sie können Präfixe verwenden, um die Daten zu organisieren, die Sie in Amazon-S3-Buckets speichern. Ein Präfix ist eine Zeichenfolge am Anfang des Objektschlüsselnamens. Ein Präfix kann eine beliebige Länge haben, abhängig von der maximalen Länge des Objektschlüsselnamens (1.024 Byte). Sie können sich Präfixe als eine Möglichkeit vorstellen, Ihre Daten ähnlich wie Verzeichnisse zu organisieren. Präfixe sind jedoch keine Verzeichnisse.

Die Suche nach Präfix begrenzt die Ergebnisse auf die Schlüssel, die mit dem angegebenen Präfix beginnen. Das Trennzeichen veranlasst Listenoperationen, alle Schlüssel mit gemeinsamem Präfix in einer Zusammenfassungsliste als Ergebnis bereitzustellen.

Zweck der Präfix- und Trennzeichen-Parameter ist es, Ihnen dabei zu helfen, Ihre Schlüssel hierarchisch zu organisieren und dann zu durchsuchen. Dazu wählen Sie zuerst ein Trennzeichen für Ihren Bucket aus, wie beispielsweise einen Schrägstrich (/), das in Ihren Schlüsselnamen voraussichtlich nicht vorkommt. Sie können ein anderes Zeichen als Trennzeichen verwenden. Der Schrägstrich (/) hat keine besonderen Eigenschaften, wird aber sehr häufig als Präfix-Trennzeichen verwendet. Anschließend konstruieren Sie Ihre Schlüsselnamen, indem Sie alle Ebenen der Hierarchie verknüpfen und jede Ebene mit dem Trennzeichen abtrennen.

Wenn Sie beispielsweise Informationen über Städte speichern, könnten Sie diese natürlich nach dem Kontinent, dann nach dem Land und dann nach der Provinz oder dem Staat anordnen. Diese Namen enthalten normalerweise keine Interpunktionszeichen, deshalb könnten Sie den Schrägstrich (/) als Trennzeichen verwenden. Die folgenden Beispiele verwenden einen Schrägstrich (/) als Trennzeichen.

Wenn Sie auf diese Weise Daten für jede Stadt in der Welt gespeichert haben, ist es relativ mühsam, einen flachen Schlüssel-Namespace zu verwalten. Durch Verwendung von Prefix und Delimiter für die Listenvorgänge können Sie die Hierarchie verwenden, die Sie zum Auflisten Ihrer Daten erstellt haben. Um beispielsweise alle Staaten der USA aufzulisten, legen Sie Delimiter='/' und Prefix='North America/USA/' fest. Um alle Provinzen in Kanada aufzulisten, für die Sie Daten haben, legen Sie Delimiter='/' und Prefix='North America/Canada/' fest.

Weitere Informationen zu Trennzeichen, Präfixen und verschachtelten Ordnern finden Sie unter Unterschied zwischen Präfixen und verschachtelten Ordnern.

Auflisten von Objekten mit Präfixen und Trennzeichen

Wenn Sie eine Listenanforderung mit einem Trennzeichen ausgeben, können Sie Ihre Hierarchie nur auf einer Ebene durchsuchen und die (möglicherweise Millionen von) Schlüsseln, die auf tieferen Ebenen verschachtelt sind, überspringen und zusammenfassen. Nehmen wir zum Beispiel an, dass Sie einen Bereich (DOC-EXAMPLE-BUCKET) mit den folgenden Schlüsseln haben:

sample.jpg

photos/2006/January/sample.jpg

photos/2006/February/sample2.jpg

photos/2006/February/sample3.jpg

photos/2006/February/sample4.jpg

Der Beispiel-Bucket hat nur das sample.jpg-Objekt auf der Root-Ebene. Um nur die Objekte auf Root-Ebene im Bucket aufzulisten, senden Sie eine GET-Anforderung mit dem Trennzeichen (/) an den Bucket. In der Antwort gibt Amazon S3 den sample.jpg-Objektschlüssel zurück, weil er das Trennzeichen / nicht enthält. Alle anderen Schlüssel enthalten das Trennzeichen. Amazon S3 gruppiert diese Schlüssel und gibt ein einziges CommonPrefixes-Element mit dem Präfix-Wert photos/ zurück, eine Unterzeichenfolge vom Anfang dieser Schlüssel bis zum Auftreten des angegebenen Trennzeichens.

<ListBucketResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
  <Name>DOC-EXAMPLE-BUCKET</Name>
  <Prefix></Prefix>
  <Marker></Marker>
  <MaxKeys>1000</MaxKeys>
  <Delimiter>/</Delimiter>
  <IsTruncated>false</IsTruncated>
  <Contents>
    <Key>sample.jpg</Key>
    <LastModified>2011-07-24T19:39:30.000Z</LastModified>
    <ETag>&quot;d1a7fb5eab1c16cb4f7cf341cf188c3d&quot;</ETag>
    <Size>6</Size>
    <Owner>
      <ID>75cc57f09aa0c8caeab4f8c24e99d10f8e7faeebf76c078efc7c6caea54ba06a</ID>
      <DisplayName>displayname</DisplayName>
    </Owner>
    <StorageClass>STANDARD</StorageClass>
  </Contents>
  <CommonPrefixes>
    <Prefix>photos/</Prefix>
  </CommonPrefixes>
</ListBucketResult>

Weitere Hinweise zum programmgesteuerten Auflisten von Objektschlüsseln finden Sie unter Programmgesteuertes Auflisten von Objektschlüsseln.