Windows Azure Storage pro PHPkáře

Jedna ze služeb poskytovaných Windows Azure je tzv. Storage. V tomto článku se zaměříme pouze na podporu Windows Azure Table Storage v PHP.

Autor: Štěpán Bechynský, Microsoft

Jedna ze služeb poskytovaných Windows Azure je tzv. Storage, které poskytuje tři typy úložišť – blob, queue a table.

  • Blob – uložiště pro nestrukturovaná data, typicky soubory
  • Queue – fronta pro zprávy
  • Table – uložiště pro strukturovaná data, typicky objekty

Podrobné informace najdete např. zde. V tomto článku se zaměříme pouze na podporu Windows Azure Table Storage v PHP.

Nemám přístup k Windows Azure, co mám dělat?

Nevadí. V podstatě celé prostředí Windows Azure můžete simulovat na lokálním počítači pomocí Windows Azure Software Development Kit. Nás bude hlavně zajímat Development Storage, která simuluje Windows Azure Storage na vašem počítači.

Klepněte pro větší obrázek

Protože Windows Azure SDK vyžaduje IIS a SQL Server 2008 (stačí Express), doporučuji nejdříve doinstalovat vše potřebné pomocí Web Platform Installer.

Přístup k Windows Azure Table Storage

Pro přístup k Windows Azure Table Storage se používá návrhový vzor REST. Stačí tedy správně sestavit URL, požadavek podepsat (http://msdn.microsoft.com/en-us/library/dd179428.aspx) a máte přístup k informacím, které jsou v tabulce uloženy. Ze serveru dostanete odpověď ve formátu ATOM. Několik příkladů:

Seznam tabulek

Požadavek:

https://msdays2010.table.core.windows.net/Tables()

Odpověď:

<?xml version="1.0" encoding="utf-8" standalone="yes"?>

<feed xml:base="https://msdays2010.table.core.windows.net/" xmlns:d="http://schemas.microsoft.com/ado/2007/08/dataservices" xmlns:m="http://schemas.microsoft.com/ado/2007/08/dataservices/metadata" xmlns="http://www.w3.org/2005/Atom">

<title type="text">Tables</title>

<id>https://msdays2010.table.core.windows.net/Tables</id>

<updated>2010-11-21T07:01:03Z</updated>

<link rel="self" title="Klepněte pro větší obrázek" href="Tables" />

<entry>

<id>https://msdays2010.table.core.windows.net/Tables('Customers')</id>

<title type="text"></title>

<updated>2010-11-21T07:01:03Z</updated>

<author>

<name />

</author>

<link rel="edit" title="Klepněte pro větší obrázek" href="Tables('Customers')" />

<category term="msdays2010.Tables" scheme="http://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />

<content type="application/xml">

<m:properties>

<d:TableName>Customers</d:TableName>

</m:properties>

</content>

</entry>

<entry>

<id>https://msdays2010.table.core.windows.net/Tables('testtable')</id>

<title type="text"></title>

<updated>2010-11-21T07:01:03Z</updated>

<author>

<name />

</author>

<link rel="edit" title="Klepněte pro větší obrázek" href="Tables('testtable')" />

<category term="msdays2010.Tables" scheme="http://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />

<content type="application/xml">

<m:properties>

<d:TableName>testtable</d:TableName>

</m:properties>

</content>

</entry>

</feed>

Obsah tabulky Customers

Požadavek:

https://msdays2010.table.core.windows.net/Customers()

Odpověď:

<?xml version="1.0" encoding="utf-8" standalone="yes"?>

<feed xml:base="https://msdays2010.table.core.windows.net/" xmlns:d="http://schemas.microsoft.com/ado/2007/08/dataservices" xmlns:m="http://schemas.microsoft.com/ado/2007/08/dataservices/metadata" xmlns="http://www.w3.org/2005/Atom">

<title type="text">Customers</title>

<id>https://msdays2010.table.core.windows.net/Customers</id>

<updated>2010-11-21T07:03:24Z</updated>

<link rel="self" title="Klepněte pro větší obrázek" href="Customers" />

<entry m:etag="W/&quot;datetime'2010-11-20T10%3A02%3A17.479744Z'&quot;">

<id>https://msdays2010.table.core.windows.net/Customers(PartitionKey='partition1',RowKey='2')</id>

<title type="text"></title>

<updated>2010-11-21T07:03:24Z</updated>

<author>

<name />

</author>

<link rel="edit" title="Klepněte pro větší obrázek" href="Customers(PartitionKey='partition1',RowKey='2')" />

<category term="msdays2010.Customers" scheme="http://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />

<content type="application/xml">

<m:properties>

<d:PartitionKey>partition1</d:PartitionKey>

<d:RowKey>2</d:RowKey>

<d:Timestamp m:type="Edm.DateTime">2010-11-20T10:02:17.479744Z</d:Timestamp>

<d:Discount m:type="Edm.Double">0.2</d:Discount>

<d:FirstName>Štěpán</d:FirstName>

<d:LastName>C#</d:LastName>

</m:properties>

</content>

</entry>

<entry m:etag="W/&quot;datetime'2010-11-20T10%3A01%3A45.6890838Z'&quot;">

<id>https://msdays2010.table.core.windows.net/Customers(PartitionKey='partition1',RowKey='4')</id>

<title type="text"></title>

<updated>2010-11-21T07:03:24Z</updated>

<author>

<name />

</author>

<link rel="edit" title="Klepněte pro větší obrázek" href="Customers(PartitionKey='partition1',RowKey='4')" />

<category term="msdays2010.Customers" scheme="http://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />

<content type="application/xml">

<m:properties>

<d:PartitionKey>partition1</d:PartitionKey>

<d:RowKey>4</d:RowKey>

<d:Timestamp m:type="Edm.DateTime">2010-11-20T10:01:45.6890838Z</d:Timestamp>

<d:FirstName>Štěpán</d:FirstName>

<d:LastName>PHP</d:LastName>

<d:Discount m:type="Edm.Double">0.1</d:Discount>

</m:properties>

</content>

</entry>

</feed>

Abyste nemuseli psát vlastní kód pro sestavování dotazů, jejich podepisování a následné zpracování odpovědí, můžete použít knihovnu Windows Azure SDK for PHP (http://phpazure.codeplex.com/).

Windows Azure SDK for PHP

Po stažení knihovny Windows Azure SDK for PHP stačí rozbalit zip archiv na libovolné místo a upravit proměnnou include_path v php.ini. Pro připojení na Windows Azure Table Storage musíte znát doménu, kde služba běží, jméno účtu (Account Name) a bezpečnostní klíč (Account Key).

Klepněte pro větší obrázek

V mém případě je doména table.core.windows.net, Account Name msdays2010 a Account Key r7h0…bQ==. Klče máte dva, kdyby se jeden prozradil, tak použijete druhý, záložní a zkompromitovaný klíč vygenerujete znovu. Pokud budete chtít použít lokální Developer Storage použijete následující nastavení (viz. http://msdn.microsoft.com/en-us/library/dd179339.aspx):

Doména: 127.0.0.1:10002

Account Name: devstoreaccount1

Account Key: Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==

Pro připojené k Windows Azure Table Storage slouží objekt Microsoft_WindowsAzure_Storage_Table. Následující kód vypíše seznam tabulek:

<?php
include_once 'Microsoft/WindowsAzure/Storage/Table.php';
$storageClient = new Microsoft_WindowsAzure_Storage_Table('127.0.0.1:10002',
'devstoreaccount1',
'Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==');
$result = $storageClient->listTables();
echo "Seznam tabulek:\r\n";
foreach ($result as $table)
{
echo "\t" . $table->Name . "\r\n";
}
?>

Vytvoření tabulky: $storageClient->createTable('Customers');

Pokud chcete do tabulky uložit nový záznam, je třeba nejdříve vytvořit třídu, která bude záznam popisovat. Protože se nejedná o relační databázi, je možné do jedné tabulky ukládat objekty, které odvozeny z různých tříd. Zjednodušeně by se dalo říct, co veřejná vlastnost třídy to pole v tabulce. Každý záznam má tři povinné vlastnosti – PartitionKey, RowKey a Timestamp. Tyto vlastnosti najdete v základní třídě Microsoft_WindowsAzure_Storage_TableEntity z které musí vaše třída vycházet. Protože je PHP slabě typový jazyk, je třeba pomocí komentářů říct, jaký datový typ budou jednotlivé vlastnosti ukládat. Popis datových typů najdete v dokumentaci (http://phpazure.codeplex.com/wikipage?title=Defining%20entities%20for%20Table%20Storage&referringTitle=Getting%20Started).

<?php
class Customer extends Microsoft_WindowsAzure_Storage_TableEntity
{
/**
* @azure FirstName Edm.String
*/
public $FirstName;
/**
* @azure LastName Edm.String
*/
public $LastName;
/**
* @azure Discount Edm.Double
*/
public $Discount = 0.1;
}
?>

Uložení záznamu pak vypadá následovně:

$customer = new Customer('partition1', 'key1');
$customer->FirstName = 'Štěpán';
$customer->LastName = 'PHP';
$result = $storageClient->insertEntity('Customers', $customer);

Vypsání všech záznamů z tabulky Customers, které jsou v partition1 a měli by být datového typu Customer:

<?php
include_once 'Microsoft/WindowsAzure/Storage/Table.php';
include_once 'Customer.php';
$storageClient = new Microsoft_WindowsAzure_Storage_Tabl
('table.core.windows.net',

'msdays2010',
'r7h0Exq+77wD+bE9MRaMAP3QvOneW/mHrcSFODADl8wVe4FqIvGvswVxW0KCzKcyGqZej43qQFm1O3qPwktXbQ==');
$entities = $storageClient->retrieveEntities(
'Customers',
'PartitionKey eq \'partition1\'',
'Customer');
foreach ($entities as $entity)
{
echo 'Name: ' . $entity->FirstName . ' ' . $entity->LastName . "\n";
}
?>

V případě, že chcete záznam změnit, je třeba ho získat na základě EntityKey a použít metodu updateEntity.

<?php
include_once 'Microsoft/WindowsAzure/Storage/Table.php';
include_once 'Customer.php';
$storageClient = new Microsoft_WindowsAzure_Storage_Tabl
('table.core.windows.net',

'msdays2010',
'r7h0Exq+77wD+bE9MRaMAP3QvOneW/mHrcSFODADl8wVe4FqIvGvswVxW0KCzKcyGqZej43qQFm1O3qPwktXbQ==');
$entity = $storageClient->retrieveEntityById('Customers', 'partition1', '4', 'Customer');
$entity->LastName = 'PHP 5';
$result = $storageClient->updateEntity('Customers', $entity, true);
?>

Záznam pak logicky odstraníte metodou deleteEntity.

Závěr

Využití Windows Azure Table Storage je velmi jednoduché, zejména když máte dostupné knihovny, které komunikaci zapouzdřují.

Štěpán Bechynský, Microsoft
Televize pro vývojáře
Vše pro vývojáře

Články ze série Microsoft TechNet nevytváří redakce Živě.cz, ale partneři programu Microsoft TechNet. Jsou publikovány v rámci mediálního partnerství Živě.cz a společnosti Microsoft.

Témata článku: Software, Microsoft, Author, Account, Term, Echo, Self, Rest

Nejnovější komentáře

Přidat příspěvek
Určitě si přečtěte

Sbíječky vyměnili za klávesnice. Nový projekt má za cíl přeučit horníky na programátory

Sbíječky vyměnili za klávesnice. Nový projekt má za cíl přeučit horníky na programátory

** Programátorů je málo a horníků bez práce po uzavření dolu Paskov bude moc ** Problém řeší unikátní projekt ** Pilotní kurz dává naději, že by z horníků mohli být použitelní kodéři

28.  11.  2016 | David Polesný | 78

ASUS ZenBook 3 se začal prodávat v Česku. Je ve všem lepší než MacBook, ale bude to stačit?

ASUS ZenBook 3 se začal prodávat v Česku. Je ve všem lepší než MacBook, ale bude to stačit?

** Novinka od Asusu míří přímo proti MacBooku od Applu ** Nabídne daleko více výkonu za stejné peníze

2.  12.  2016 | David Polesný | 119