Zend_Service_WindowsAzure_Storage_TableDer Table Service bietet einen strukturierten Speicher in der Form von Tabellen. Tabellen Speicher wird von Windows Azure als REST API angeboten die von der Klasse Zend_Service_WindowsAzure_Storage_Table umhüllt ist um ein natives PHP Interface zum Speicher Konto zu bieten. Dieses Thema zeigt einige Beispiele der Verwendung der Klasse Zend_Service_WindowsAzure_Storage_Table. Andere Features sind im Download Paket enthalten sowie in den detailierten API Dokumentationen dieser Features. Es ist zu beachten das bei der Entwicklung der Tabellen Speicher (in der SDK von Windows Azure) nicht alle Features unterstützt welche von dieser API angeboten werden. Deshalb sind die Beispiele welche auf dieser Seite aufgeführt sind, dazu gedacht auf Windows Azure Produktions Tabellen Speichern verwendet zu werden. Operationen auf TabellenDieses Thema zeigt einige Beispiele für Operationen welche auf Tabellen ausgeführt werden können. Erstellung einer TabelleBei Verwendung des folgenden Codes, kann eine Tabelle auf dem Windows Azure Produktions Tabellen Speicher erstellt werden. Example #1 Erstellen einer Tabelle
Ausgeben aller TabellenBei Verwendung des folgendes Codes, kann eine Liste alle Tabellen im Windows Azure Produktions Tabellen Speicher abgefragt werden. Example #2 Ausgeben aller Tabellen
Operationen auf EntitätenTabellen speichern Daten als Sammlung von Entitäten. Entitäten sind so ähnlich wie Zeilen. Eine Entität hat einen primären Schlüssel und ein Set von Eigenschaften. Eine Eigenschaft ist ein benanntes, Typ-Werte Paar, ähnlich einer Spalte. Der Tabellen Service erzwingt kein Schema für Tabellen, deshalb können zwei Entitäten in der selben Tabelle unterschiedliche Sets von Eigenschaften haben. Entwickler können auswählen das ein Schema auf Seite des Clients erzwungen wird. Eine Tabelle kann eine beliebige Anzahl an Entitäten enthalten. Zend_Service_WindowsAzure_Storage_Table bietet 2 Wege um mit Entitäten zu arbeiten:
Alle Beispiel verwenden die folgende erwzungene Schema Klasse. Example #3 Erzwungenes Schema welches in Beispielen verwendet wird
Es ist zu beachten das Zend_Service_WindowsAzure_Storage_Table, wenn keine Schema Klasse an die Tabellen Speicher Methoden übergeben, automatisch mit Zend_Service_WindowsAzure_Storage_DynamicTableEntity arbeitet. Erzwungene Schema EntitätenUm ein Schema auf der Seite des Clients bei Verwendung der Klasse Zend_Service_WindowsAzure_Storage_Table zu erzwingen muss eine Klasse erstellt werden welche sich von Zend_Service_WindowsAzure_Storage_TableEntity ableitet. Diese Klasse bietet einige grundsätzliche Funktionalitäten damit die Klasse Zend_Service_WindowsAzure_Storage_Table mit einem client-seitigen Schema arbeitet. Grundsätzliche Eigenschaften welche von Zend_Service_WindowsAzure_Storage_TableEntity angeboten werden sind:
Hier ist eine Beispielklasse welche sich von Zend_Service_WindowsAzure_Storage_TableEntity ableitet: Example #4 Beispiel einer erzwungenen Schema Klasse
Die Klasse Zend_Service_WindowsAzure_Storage_Table mappt jede Klasse welche sich von Zend_Service_WindowsAzure_Storage_TableEntity ableitet auf Windows Azure Tabellen Speicher Entitäten mit dem richtigen Datentyp und dem Namen der Eigenschaft. Alles dort dient dem Speichern einer Eigenschaft in Windows Azure indem ein Docblock Kommentar zu einer öffentlichen Eigenschaft oder einem öffentlichen Getter oder Setter, im folgenden Format hinzugefügt wird: Example #5 Erzwungene Eigenschaft
Sehen wir uns an wie eine Eigenschaft "Ago" als Integerwert eines Windows Azure Tabellen Speichers definiert wird: Example #6 Beispiel einer erzwungenen Eigenschaft
Es ist zu beachten das die Eigenschaft im Windows Azure Tabellen Speicher nicht notwendigerweise gleich benannt werden muss. Der Name der Windows Azure Tabellen Speicher Eigenschaft kann genauso definiert werden wie der Typ. Die folgenden Datentypen werden unterstützt:
Entitäten ohne erzwungenes Schema (a.k.a. DynamicEntity)Um die Klasse Zend_Service_WindowsAzure_Storage_Table ohne Definition eines Schemas zu verwenden kann die Klasse Zend_Service_WindowsAzure_Storage_DynamicTableEntity verwendet werden. Diese Klasse erweitert Zend_Service_WindowsAzure_Storage_TableEntity wie es eine Klasse für ein erzwungenes Schema machen würde, enthält aber zusätzliche Logik um Sie dynamisch zu machen und nicht an ein Schema zu binden. Die grundsätzlichen Eigenschaften welche von Zend_Service_WindowsAzure_Storage_DynamicTableEntity angeboten werden sind:
Andere Eigenschaften können on the Fly hinzugefügt werden. Ihre Windows Azure Tabellen Speicher Typen werden auch on the Fly ermittelt: Example #7 Eigenschaften zu Zend_Service_WindowsAzure_Storage_DynamicTableEntity dynamisch hinzufügen
Optional kann der Typ einer Eigenschaft erzwungen werden: Example #8 Erzwingen von Eigenschaftstypen auf Zend_Service_WindowsAzure_Storage_DynamicTableEntity
Die Klasse Zend_Service_WindowsAzure_Storage_Table arbeitet automatisch mit Zend_Service_WindowsAzure_Storage_TableEntity wenn an die Tabellen Speicher Methoden keine spezielle Klasse übergeben wurde. API Beispiele für EntitätenEine Entität hinzufügenBei Verwendung des folgenden Codes kann eine Entität in eine Tabelle hinzugefügt werden welche "testtable" heißt. Es ist zu beachten das die Tabelle vorher schon erstellt worden sein muss. Example #9 Eine Entität einfügen
Empfangen einer Entität durch Partitionsschlüssel und ZeilenschlüsselDurch Verwendung des folgenden Codes kann eine Entität durch seinen Partitions- und Zeilenschlüssel. Es ist zu beachten das die Tabelle und die Entität bereits vorher erstellt worden sein müssen. Example #10 Empfangen einer Entität durch dessen Partitions- und Zeilenschlüssel
Eine Entität aktualisierenBei Verwendung des folgenden Codes kann eine Entität aktualisiert werden. Es ist zu beachten das die Tabelle und die Entität hierfür bereits vorher erstellt worden sein muss. Example #11 Aktualisieren einer Entität
Wenn man sicherstellen will das die Entität vorher noch nicht aktualisiert wurde kann man prüfen ob das Etag der Entität angehakt ist. Wenn die Entität bereits aktualisiert wurde, schlägt das Update fehl um sicherzustellen das neuere Daten nicht überschrieben werden. Example #12 Aktualisieren einer Entität (mit Etag Prüfung)
Löschen einer EntitätBei Verwendung des folgenden Codes kann eine Entität gelöscht werden. Es ist zu beachten das die Tabelle und die Entität hierfür bereits erstellt worden sein müssen. Example #13 Löschen einer Entität
Durchführen von AbfragenAbfragen im Zend_Service_WindowsAzure_Storage_Table Tabellen Speicher können auf zwei Wegen durchgeführt werden:
Bei Verwendung des folgenden Codes kann eine Tabelle abgefragt werden indem eine Filter Kondition verwendet wird. Es ist zu beachten das die Tabelle und die Entitäten hierfür vorher bereits erstellt worden sein müssen. Example #14 Durchführen einer Abfrage bei Verwendung einer Filter Kondition
Durch Verwendung des folgenden Codes kann eine tabelle abgefragt werden indem ein fluid Interface verwendet wird. Es ist zu beachten das die Tabelle und die Entität hierfür bereits vorher erstellt worden sein müssen. Example #15 Durchführen einer Abfrage bei Verwendung eines Fluid Interfaces
Batch OperationenDieser Abschnitt demonstriert wie die Tabellen Entitäts Gruppen Transaktions Features verwendet werden können welche vom Windows Azure Tabellen Speicher angeboten werden. Der Windows Azure Tabellen Speicher unterstützt Batch Transaktionen auf Entitäten welche in der gleichen Tabelle sind und der gleichen Partitionsgruppe angehören. Eine Transaktion kann bis zu 100 Entitäten enthalten. Das folgende Beispiel verwendet eine Batch Operation (Transaktion) um ein Set von Entitäten in die Tabelle "testtable" einzufügen. Es ist zu beachten das die Tabelle hierfür bereits vorher erstellt worden sein muss. Example #16 Ausführen einer Batch Operation
Session Handler für Tabellen SpeicherWenn eine PHP Anwendung auf der Windows Azure Plattform in einem Load-Balanced Modus läuft (wenn 2 oder mehr Web Rollen Instanzen laufen), ist es wichtig dass PHP Session Daten zwischen mehreren Web Rollen Instanzen verwendet werden können. Die Windows Azure SDK von PHP bietet die Klasse Zend_Service_WindowsAzure_SessionHandler an welche den Windows Azure Tabellen Speicher als Session Handler für PHP Anwendungen verwendet. Um den Zend_Service_WindowsAzure_SessionHandler Session Handler zu verwenden sollte er als Default Session Handler für die PHP Anwendung registriert sein: Example #17 Registrierung des Tabellen Speicher Session Handlers
Der obenstehende Klassenname registriert den Zend_Service_WindowsAzure_SessionHandler Session Handler und speichert Sessions in einer Tabelle die "sessionstable" genannt wird. Nach der Registrierung des Zend_Service_WindowsAzure_SessionHandler Session Handlers können Session gestartet und auf dem gleichen Weg wie normale PHP Sessions verwendet werden: Example #18 Verwendung des Tabellen Speicher Session Handlers
Warning
Der Zend_Service_WindowsAzure_SessionHandler Session Handler sollte registriert werden bevor ein Aufruf zu session_start() durchgeführt wird!
|
|