From SA-MP Wiki

db_open

Nota Importante

Tipo de retorno para esta função mudou desde a versão 0.3.7 R2.

Descrição:

Valores de retorno:

Nota Importante

Ele vai criar um novo banco de dados SQLite, se não houver uma base de dados SQLite com o mesmo nome de arquivo disponível.

Nota Importante

Feche sua conexão com banco de dados usando a função db_close!

Exemplo de uso:

new DB:db_handle;
// ...
public OnGameModeInit()
{
	// Cria uma conexão com o banco de dados.
	if((db_handle = db_open("exemplo.db")) == DB:0)
	{
		// Exibe um erro no console caso o banco de dados não seja encontrado.
		print("Não foi possível encontrar \"exemplo.db\".");
		SendRconCommand("exit");
	}
	else
	{
		// Se o banco de dados for encontrado, gera uma mensagem de sucesso.
		print("Conexão com \"exemplo.db\" efetuada!");
	}
	// ...
	return 1;
}
 
public OnGameModeExit()
{
	// Fecha a conexão com o banco de dados...
	db_close(db_handle);
	// ...
	return 1;
}

Você pode também criar mais de uma conexão usando a mesma variável, veja o exemplo:

Exemplo de uso:

new DB:db_handle[3];
// ...
public OnGameModeInit()
{
	db_handle[0] = db_open("mydb1.db");
	db_handle[1] = db_open("mydb2.db");
	db_handle[2] = db_open("mydb3.db");
	return 1;
}

Funções Relacionadas

As seguintes funções podem ser úteis, pois estão de alguma forma, relacionadas a esta função.

• db_open: Abre conexão com o banco de dados SQLite.

• db_close: Finaliza a conexão com o banco de dados SQLite.

• db_query: Envia uma consulta para o banco de dados SQLite.

• db_free_result: Libera o resultado da consulta, gerado pela função db_query

• db_num_rows: Pega um número de linhas de um resultado de uma consulta.

• db_next_row: Passa para a próxima linha de um resultado de uma consulta.

• db_num_fields: Pega o número de campos de um resultado de uma consulta.

• db_field_name: Pega o nome de um determinado campo pelo resultado da consulta.

• db_get_field: Pega o valor de um campo pelo índice do campo.

• db_get_field_assoc: Pega o valor do resultado de uma consulta pelo nome do campo.

• db_get_field_int: Pega um valor inteiro de um resultado de uma consulta pelo índice do campo.

• db_get_field_assoc_int: Pega um valor inteiro de um resultado de uma consulta pelo nome do campo.

• db_get_field_float: Pela um valor flutuante do resultado de uma consulta pelo índice do campo.

• db_get_field_assoc_float: Pega um valor flutuante do resultado de uma consulta pelo nome do campo.

• db_get_mem_handle: Pegar um identificador de memória para um banco de dados SQLite que foi aberto com db_open.

• db_get_result_mem_handle: Pegar um identificador de memória para uma consulta SQLite que foi executada com db_query.

• db_desbug_openfiles Pega o número de conexões abertas com a função db_open.

• db_desbug_openresults Pega o número de resultados abertos com a função db_query.