Dúvidas - Banco de Dados

[Lucy]

Fala ai pessoal! Blz?

Alguém pode me tirar algumas dúvidas, relacionadas a banco de dados?

 

Para que serve um banco de dados no MTA:SA ?

Melhora o desempenho do servidor, reduz o lag ?

Scripts são desenvolvidos com outras funções para ser utilizados juntamente com o banco de dados ?

 

Agradeço!

[Lord Henry]

Isso poderia ter sido perguntado na sessão de scripting.

Um banco de dados é onde ficam salvos diversos tipos de dados que são usados entre as sessões dos jogadores e do servidor, isto significa que mesmo se o jogador relogar no servidor ou até mesmo o servidor reiniciar, os dados salvos no banco de dados não são perdidos. (se o script que salvou lá foi feito corretamente).
O MTA já cria 2 bancos de dados padrão quando vc cria seu servidor, são eles:

• internal.db - Onde são salvos todos os dados das contas dos jogadores, login, senha, grana do bolso, posição do jogador quando deslogou, vida, colete, skin, armas, munição, etc.
• registry.db - Onde são salvos todos os dados que são utilizados pelos resources, como por exemplo melhores pontuações das corridas (race gamemode), proprietários das casas, dados bancários dos jogadores, saldo bancário dos jogadores, carros comprados pelos jogadores, roupas compradas pelos jogadores, empresas adquiridas pelos jogadores, etc.

Estes dois banco de dados estão na pasta deathmatch do seu servidor, estão na linguagem SQLite. Você ainda pode criar outros bancos de dados, para serem usados pelos resources, mas na minha opinião isso não é recomendável, uma vez que vc usaria MySQL, que é mais complexo e exige certos cuidados de acesso e domínio, mas alguns servidores profissionais precisam fazer assim pois fizeram os bancos de dados ficarem fora do servidor em outro IP por segurança, dai é necessário ter bancos de dados externos.

Para salvar alguma coisa na conta do jogador, isto é, no internal.db, você usa setAccountData, e para recuperar esses dados depois, use getAccountData.
Para salvar alguma coisa no registry.db, é um pouco mais complicado, uma vez que vc vai precisar criar uma tabela nova para cada resource. Por exemplo, vc acabou de criar um resource de ranking por kills/deaths e você deseja salvar esse ranking no banco de dados para que ao reiniciar o resource ou o servidor, o ranking não seja perdido. Para isso vc vai precisar primeiramente criar uma tabela no banco de dados registry.db, essa tabela será acessada pelo resource, que irá salvar os dados dele lá. Para fazer qualquer coisa neste banco de dados (criar tabelas, inserir/alterar/remover valores em determinada tabela, deletar determinada tabela, inserir colunas em determinada tabela, etc) vc vai precisar usar isso: executeSQLQuery. (aqui, será necessário conhecimento em SQLite para fazer isso, mas é mais fácil do que aprender uma linguagem de programação nova, pois suas opções e sintaxes são menores do que uma linguagem inteira de programação, você não vai inventar nenhum sistema novo aqui, apenas criar e gerenciar tabelas e dados.)

• Criar tabela nova no banco de dados: (o Caps Lock não é uma regra, mas é melhor para entender oq é código e oq é nome)
  [Os seguintes códigos só funcionam server-side]

  executeSQLQuery ("CREATE TABLE IF NOT EXISTS nomedatabela (nomecoluna1 TEXT, nomecoluna2 REAL, nomecoluna3 INTEGER)")

  TEXT = Valores desta coluna serão textos. Podem ter símbolos, números e espaços.
  REAL = Valores desta coluna serão numéricos reais. (números com vírgula, positivos, negativos e 0.0)
  INTEGER = Valores desta coluna serão numéricos inteiros. (positivos, negativos e 0)
  (não existe tipo BOOLEAN, use TEXT e insira valor "false" ou "true")
  (existe valor NULL, é diferente de vazio, mas NULL não é um tipo de dado e sim um valor nulo. Você pode atribuir valor NULL a qualquer célula.)
   
• Deletar tabela do banco de dados:

  executeSQLQuery ("DROP TABLE nomedatabela")

  Todas as linhas, colunas, células e valores desta tabela são deletados junto.
   
• Deletar linhas da tabela: (as células não ficarão NULL)

  executeSQLQuery ("DELETE FROM nomedatabela WHERE colunaespecífica=?", valorDaCelulaEspecifica)

  O ? indica que o valor está após a declaração do SQL. Você poderia colocar o valor direto no lugar do ?. Mas por alguma razão, as vezes isso gera erro. Além disso, se o valor da célula estiver em uma variável no seu script, você não pode declarar a variável no lugar do ?. Ali só pode ser o valor direto, pois a declaração SQL inteira se trata de uma string. Por isso o uso do ?, que está recebendo o valor da variável que está depois da vírgula.
  Obs: Para verificar se uma célula tem valor nulo, não se usa os operadores lógicos de ==, <= >=. Para isso, usa-se IS NULL ou IS NOT NULL. Ex:

  executeSQLQuery ("DELETE nomecoluna1,nomecoluna2 FROM nomedatabela WHERE nomecoluna3 IS NULL")

  Isso vai deletar todas as células da linha onde a coluna 3 tem uma célula de valor NULL. Se a coluna 3 não tiver nenhuma célula de valor NULL, nada acontece.
   
• Inserir nova linha de valores: (ele vai criar automaticamente uma nova linha com novas células)

  executeSQLQuery ("INSERT INTO nomedatabela(nomecoluna1,nomecoluna2,nomecoluna3) VALUES(?,?,?)", valorCelulaColuna1, valorCelulaColuna2, valorCelulaColuna3)

  Neste caso, ele está inserindo 3 novos valores, cada valor em uma coluna. Se você não declarar os nomes das colunas, ele vai preencher na ordem das colunas automaticamente. Você pode deixar de declarar uma coluna se não quiser atribuir valor na célula daquela coluna. Se o tipo de valor da variável não for do tipo de dado daquela coluna, dará erro.
   
• Atualizar valores de células que já existem em uma tabela: (não é possível alterar os tipos de valores, é necessário editar o tipo da coluna se quiser fazer isso)

  executeSQLQuery ("UPDATE nomedatabela SET nomecoluna2=?,nomecoluna3=? WHERE nomecoluna1=?", valorCelulaColuna2, valorCelulaColuna3, valorCelulaColuna1)

  No caso acima, ele vai atualizar as células das colunas 2 e 3 onde o valor da célula da coluna 1 for igual ao valor de valorColunaCelula1.
  OBS:
  Nada impede que você coloque as primeiras variáveis junto à declaração SQL, mas para fazer isso você deve "cortar" a string, inserir as variáveis e depois continuar a string, Ex:

  executeSQLQuery ("UPDATE nomedatabela SET nomecoluna2= '".. valorCelulaColuna2 .."',nomecoluna3='".. valorCelulaColuna2 .."' WHERE nomecoluna1=?", valorCelulaColuna1)

  Lembrando que o valor destas variáveis também são strings na declaração, portanto use aspas simples antes e depois de cada corte para transformar os valores em string. Os dois pontos (..) significam que estes valores fazem parte do argumento SQL. Da mesma forma, se vc usar "1" .. "1", será igual a "11". (Por isso acho muito mais fácil deixar tudo ? na declaração SQL e colocar as variáveis todas após a string.)
   
• Selecionar determinadas células da tabela: (usado geralmente para obter os valores destas células para usar no script, você pode selecionar somente 1 célula ou várias)

  executeSQLQuery ("SELECT nomecoluna1,nomecoluna2 FROM nomedatabela WHERE nomecoluna3=?", valorCelulaColuna3)

  Neste exemplo, ele vai selecionar a célula da coluna 1 e a célula da coluna 2, na linha onde a célula da coluna 3 for igual a valorCelulaColuna3.
   
• Alterar a tabela (adicionar coluna nova) [SQLite não suporta deletar coluna nem editar tipo de coluna]

  executeSQLQuery ("ALTER TABLE nomedatabela ADD nomecoluna4 REAL")

  Devido a limitações do SQLite, ALTER TABLE não pode ser usado para deletar uma coluna nem para editar seu tipo. Para fazer isso é necessário recriar a tabela inteira com as novas alterações.
  No exemplo acima, ele vai adicionar uma nova coluna chamada "nomecoluna4".

Fiz um código com vários testes de banco de dados. Cada comando faz alguma coisa.

Spoiler

addEventHandler("onResourceStart", getResourceRootElement(getThisResource()), function()
	executeSQLQuery ("CREATE TABLE IF NOT EXISTS tabelaLegal (ID INTEGER NOT NULL PRIMARY KEY, PosX REAL, PosY REAL, PosZ REAL, accountName TEXT)")
	print ("Table created.") -- Manda isso no /debugscript 3, só para testes.
end) -- Cria uma tabela chamada "tabelaLegal" no banco de dados registry.db, com as colunas "ID", "PosX", "PosY", "PosZ", "accountName". Onde a coluna ID irá se preencher automaticamente com o ID anterior +1.


addCommandHandler ("add", function(player, cmd, val1, val2) -- Use /add 2.2 teste123
	if not val2 then
		print ("Erro: Faltaram parâmetros.")
		return
	end
	executeSQLQuery ("INSERT INTO tabelaLegal(PosX,accountName) VALUES(?,?)", val1, val2)
	print ("Valores novos adicionados na tabela.") -- Adiciona uma linha de células com os valores informados nas colunas PosX e accountName. As demais células da linha serão NULL e a célula da coluna ID recebe o ID da linha anterior + 1.
end)


addCommandHandler ("addall", function(player, cmd, val1, val2, val3, val4)
	if not val4 then
		print ("Erro: Faltaram parâmetros.")
		return
	end
	executeSQLQuery ("INSERT INTO tabelaLegal VALUES(NULL,?,?,?,?)", val1, val2, val3, val4) -- No caso, as colunas não foram informadas, então ele vai preencher cada uma em ordem.
	print ("Linha inteira adicionada na tabela.") -- Adiciona uma linha de células com os valores informados na ordem das colunas.
end)


addCommandHandler ("addrestored", function()
	local registros = executeSQLQuery ("SELECT * FROM tabelaLegal") -- Seleciona a tabela inteira.
	for i=1, #registros do -- #registros é o número de linhas da tabela.
		local result = executeSQLQuery ("SELECT ID FROM tabelaLegal WHERE ID=?", i)
		if(#result == 0) then -- O #result é quantos IDs = i foram encontrados.
			executeSQLQuery ("INSERT INTO tabelaLegal VALUES(?,NULL,NULL,NULL,NULL)", i) -- Cria uma nova linha com o ID perdido, com valores nulos.
			print ("ID "..i.." restaurado com valores nulos.")
		end
	end -- Se não existe nenhum ID perdido, nada acontece. Os IDs não precisam estar necessariamente em ordem.
end) -- Para testar isso, crie 2 linhas. Depois delete a primeira linha.


addCommandHandler ("del", function(player, cmd, numero)
	if not numero then
		print ("Erro: Faltou parâmetro.")
		return
	end
	executeSQLQuery ("DELETE FROM tabelaLegal WHERE ID=?", numero)
	print ("A linha inteira do ID "..numero.." foi deletada da tabela.") -- Deleta a linha onde a coluna ID tem o valor informado. Se vc quer apenas apagar os dados da linha sem deletar as células, preencha-as com vazio em vez disso.
end)


addCommandHandler ("delnull", function()
	executeSQLQuery ("DELETE FROM tabelaLegal WHERE accountName IS NULL")
	print ("A linha nula foi deletada da tabela.") -- Deleta a linha onde a coluna accountName tem célula de valor NULL. Se mais de uma linha possuir accountName de valor NULL, ele vai deletar também.
end)


addCommandHandler ("delall", function()
	executeSQLQuery ("DELETE FROM tabelaLegal")
	print ("A tabela foi limpada.") -- Deleta tudo da tabela, mas mantém as colunas.
end)


addCommandHandler ("deltable", function()
	executeSQLQuery ("DROP TABLE tabelaLegal")
	print ("A tabela inteira foi deletada.") -- Deleta a tabela inteira, incluindo suas colunas, linhas, células e dados.
end)


addCommandHandler ("size", function()
	local registros = executeSQLQuery ("SELECT * FROM tabelaLegal")
	print ("Existem atualmente "..#registros.." registros na tabela.") -- Mostra quantas linhas existem na tabela.
end)


addCommandHandler ("edit", function(player, cmd, id, val1, val2, val3, val4) -- Tente /edit 1 11 22 33 44
	executeSQLQuery ("UPDATE tabelaLegal SET PosX=?,PosY=?,PosZ=?,accountName=? WHERE ID=?", val1, val2, val3, val4, id)
	print ("O registro "..id.." foi atualizado.") -- Atualiza os registros do ID específico com os valores específicos.
	print ("PosX: "..val1)
	print ("PosY: "..val2)
	print ("PosZ: "..val3)
	print ("accountName: "..val4)
end)


addCommandHandler ("editempty", function(player, cmd, id)
	executeSQLQuery ("UPDATE tabelaLegal SET PosX=?,PosY=?,PosZ=?,accountName=? WHERE ID=?", "", "", "", "", id)
	print ("O registro "..id.." foi limpado.") -- Deixa todos os registros do ID específico vazios.
end)


addCommandHandler ("coluna", function()
	executeSQLQuery ("ALTER TABLE tabelaLegal ADD colunaQualquer TEXT")
	print ("Coluna adicionada.") -- Adiciona uma coluna chamada "colunaQualquer" na tabela.
end)

 

 

Espero ter ajudado.
Boa sorte.

 

Edited April 1, 2018 by Lord Henry

[Lord Henry]

Resumindo todas as suas perguntas:

Quote

Para que serve um banco de dados no MTA:SA ?

Salvar dados entre as sessões dos jogadores, evitando que percam tudo ao deslogar.

Quote

Melhora o desempenho do servidor, reduz o lag ?

Depende do script, e da quantidade de acessos simultâneos que é feito no banco de dados. Acessar um banco de dados não é tão leve assim.
O uso de banco de dados se deve com o objetivo de salvar dados entre as sessões, não para poupar processamento.
É claro que, é muito mais viável e mais leve você salvar em um banco de dados do que ficar criando mil variáveis no seu script. Imagine salvar cada coordenada dos jogadores em uma variável do seu script, cada jogador iria consumir a memória de 3 variáveis só para salvar sua posição.

Quote

Scripts são desenvolvidos com outras funções para ser utilizados juntamente com o banco de dados ?

Sim. Um grande exemplo disso é o sistema de casas. A staff cria as casas no servidor e elas ficam lá mesmo se o servidor for reiniciado. Para salvar as posições e configurações de cada casa, o script salva tudo no banco de dados. Ao ser iniciado, o script carrega os dados novamente e já cria as casas nas posições e configurações salvas. Além é claro, de salvar os proprietários das casas, para não ser necessário comprar novamente a casa após reiniciar o resource.

[Lucy]

@Lord Henry, muito obrigado por sanar minhas dúvidas, e por apresentar essa aula!

Entendi perfeitamente para que serve um banco de dados. Texto muito explicativo e de fácil entendimento.

Desculpas pelo local de postagem incorreto. 

 

Obrigado!!

[main]

@Lord Henry além de ter ajudado o rapaz, me ajudou muito também, eu tinha algumas dúvidas sobre o sql e fiquei satisfeito em ler este post, obrigado.

[Lord Henry]

De nada.
Que bom que lhes ajudei.