Usando el siguiente código, se puede crear una tabla en el almacenamiento de tablas de producción de Windows Azure.

$storageClient = new Zend_Service_WindowsAzure_Storage_Table(
    'table.core.windows.net', 'myaccount', 'myauthkey'
);
$result = $storageClient->createTable('testtable');

echo 'New table name is: ' . $result->Name;

Usando el siguiente código, se puede consultar una lista de todas las tablas del almacenamiento de tablas de producción de Windows Azure.

$storageClient = new Zend_Service_WindowsAzure_Storage_Table(
    'table.core.windows.net', 'myaccount', 'myauthkey'
);
$result = $storageClient->listTables();
foreach ($result as $table) {
    echo 'Table name is: ' . $table->Name . "\r\n";
}

Para imponer un esquema en el lado del cliente usando la clase Zend_Service_WindowsAzure_Storage_Table, puede crear una clase que herede de Zend_Service_WindowsAzure_Storage_TableEntity. Esta clase proporciona alguna funcionalidad básica para que la clase Zend_Service_WindowsAzure_Storage_Table trabaje con un esquema del lado del cliente.

Las propiedades base proporcionadas por Zend_Service_WindowsAzure_Storage_TableEntity son:

Aquí tiene una clase de ejemplo que hereda de Zend_Service_WindowsAzure_Storage_TableEntity:

class SampleEntity extends Zend_Service_WindowsAzure_Storage_TableEntity
{
    /**
     * @azure Name
     */
    public $Name;

    /**
     * @azure Age Edm.Int64
     */
    public $Age;

    /**
     * @azure Visible Edm.Boolean
     */
    public $Visible = false;
}

La clase Zend_Service_WindowsAzure_Storage_Table asignará cualquier clase heredada de Zend_Service_WindowsAzure_Storage_TableEntity a entidades de table storage de Windows Azure con el tipo de dato y nombre de propiedad correctos. Todo lo que hay que hacer para almacenar una propiedad en Windows Azure es añadir un comentario docblock a una propiedad pública o a un getter/setter público, con el siguiente formato:

/**
 * @azure <property name in Windows Azure> <optional property type>
 */
public $<property name in PHP>;

Veamos cómo definir una propiedad "Age" como un entero en el table storage de Windows Azure:

/**
 * @azure Age Edm.Int64
 */
public $Age;

Tenga en cuenta que una propiedad no tiene por qué llamarse igual en el table storage de Windows Azure. El nombre de la propiedad en el table storage de Windows Azure puede definirse, así como el tipo.

Se admiten los siguientes tipos de datos:

Para usar la clase Zend_Service_WindowsAzure_Storage_Table sin definir un esquema, puede hacer uso de la clase Zend_Service_WindowsAzure_Storage_DynamicTableEntity. Esta clase hereda de Zend_Service_WindowsAzure_Storage_TableEntity igual que una clase de esquema forzado, pero contiene lógica adicional para hacerla dinámica y no estar ligada a un esquema.

Las propiedades base proporcionadas por Zend_Service_WindowsAzure_Storage_DynamicTableEntity son:

Se pueden añadir otras propiedades sobre la marcha. Su tipo en el table storage de Windows Azure se determinará dinámicamente:

$target = new Zend_Service_WindowsAzure_Storage_DynamicTableEntity(
    'partition1', '000001'
);
$target->Name = 'Name'; // Will add property "Name" of type "Edm.String"
$target->Age  = 25;     // Will add property "Age" of type "Edm.Int32"

Opcionalmente, se puede forzar un tipo de propiedad:

$target = new Zend_Service_WindowsAzure_Storage_DynamicTableEntity(
    'partition1', '000001'
);
$target->Name = 'Name'; // Will add property "Name" of type "Edm.String"
$target->Age  = 25;     // Will add property "Age" of type "Edm.Int32"

// Change type of property "Age" to "Edm.Int32":
$target->setAzurePropertyType('Age', 'Edm.Int64');

La clase Zend_Service_WindowsAzure_Storage_Table trabaja automáticamente con Zend_Service_WindowsAzure_Storage_TableEntity si no se pasa ninguna clase específica a los métodos de Table Storage.

Las consultas en el table storage de Zend_Service_WindowsAzure_Storage_Table pueden realizarse de dos maneras:

Usando el siguiente código, se puede consultar una tabla usando una condición de filtro. Tenga en cuenta que la tabla y las entidades ya han sido creadas previamente.

$storageClient = new Zend_Service_WindowsAzure_Storage_Table(
    'table.core.windows.net', 'myaccount', 'myauthkey'
);
$entities = $storageClient->storageClient->retrieveEntities(
    'testtable',
    'Name eq \'Maarten\' and PartitionKey eq \'partition1\'',
    'SampleEntity'
);

foreach ($entities as $entity) {
    echo 'Name: ' . $entity->Name . "\n";
}

Usando el siguiente código, se puede consultar una tabla usando una interfaz fluida. Tenga en cuenta que la tabla y las entidades ya han sido creadas previamente.

$storageClient = new Zend_Service_WindowsAzure_Storage_Table(
    'table.core.windows.net', 'myaccount', 'myauthkey'
);
$entities = $storageClient->storageClient->retrieveEntities(
    'testtable',
    $storageClient->select()
                  ->from($tableName)
                  ->where('Name eq ?', 'Maarten')
                  ->andWhere('PartitionKey eq ?', 'partition1'),
    'SampleEntity'
);

foreach ($entities as $entity) {
    echo 'Name: ' . $entity->Name . "\n";
}

Este tema muestra cómo usar las características de transacción de grupo de entidades de tabla proporcionadas por el table storage de Windows Azure. El table storage de Windows Azure admite transacciones por lotes sobre entidades que están en la misma tabla y pertenecen al mismo grupo de partición. Una transacción puede incluir como máximo 100 entidades.

El siguiente ejemplo usa una operación por lotes (transacción) para insertar un conjunto de entidades en la tabla "testtable". Tenga en cuenta que la tabla ya ha sido creada previamente.

$storageClient = new Zend_Service_WindowsAzure_Storage_Table(
    'table.core.windows.net', 'myaccount', 'myauthkey'
);

// Start batch
$batch = $storageClient->startBatch();

// Insert entities in batch
$entities = generateEntities();
foreach ($entities as $entity) {
    $storageClient->insertEntity($tableName, $entity);
}

// Commit
$batch->commit();