Algumas funções da camada de abstração de banco de dados do Drupal

db_query

Executa uma consulta básica no banco de dados ativo

Exemplo

$result = db_query("SELECT node.nid, node.title FROM {node}
                    WHERE node.type LIKE '%s'
                    ORDER BY node.created DESC","noticia");

Repare no uso do marcador ‘%s’, que teve seu valor indicado como argumento logo após a consulta SQL. O uso desses marcadores é altamente recomendado pelo Drupal e funciona de forma semelhante à função sprintf() do PHP.

Outro detalhe importante é que o nome da tabela está entre chaves { }, para que o Drupal detecte a tabela e adicione o prefixo definido no ato da instalação, caso ele exista.

db_query_range

Executa uma função básica no banco de dados ativo, recebendo como parâmetros adicionais os índices do primeiro e do último registro a ser exibido.

Exemplo

$result = db_query_range("SELECT node.nid, node.title FROM {node}
			  WHERE node.type LIKE '%s'
			  ORDER BY node.created DESC","noticia",3,10);

Essa função retornará do terceiro ao décimo registros (últimos parâmetros) da consulta.

db_affected_rows

Essa retorna um número inteiro correspondente ao total de registros obtidos na última consulta realizada.

Exemplo

print db_affected_rows(); // imprime 7

db_fetch_object

Traz cada linha do resultado de uma consulta como um objeto.

Exemplo

while ($node = db_fetch_object($result)) {
    print $node->title;
}

db_fetch_array

Traz cada linha do resultado de uma consulta como um array.

Exemplo

while ($node = db_fetch_object($result)) {
    print $node['title'];
}