Django
Configurazione del database
Ricerca…
MySQL / MariaDB
Django supporta MySQL 5.5 e versioni successive.
Assicurati di avere alcuni pacchetti installati:
$ sudo apt-get install mysql-server libmysqlclient-dev
$ sudo apt-get install python-dev python-pip # for python 2
$ sudo apt-get install python3-dev python3-pip # for python 3
Oltre a uno dei driver MySQL di Python ( mysqlclient
la scelta consigliata per Django):
$ pip install mysqlclient # python 2 and 3
$ pip install MySQL-python # python 2
$ pip install pymysql # python 2 and 3
La codifica del database non può essere impostata da Django, ma deve essere configurata a livello di database. Cerca
default-character-set
in my.cnf (o/etc/mysql/mariadb.conf/*.cnf
) e imposta la codifica:
[mysql]
#default-character-set = latin1 #default on some systems.
#default-character-set = utf8mb4 #default on some systems.
default-character-set = utf8
...
[mysqld]
#character-set-server = utf8mb4
#collation-server = utf8mb4_general_ci
character-set-server = utf8
collation-server = utf8_general_ci
Configurazione del database per MySQL o MariaDB
#myapp/settings/settings.py
DATABASES = {
'default': {
'ENGINE': 'django.db.backends.mysql',
'NAME': 'DB_NAME',
'USER': 'DB_USER',
'PASSWORD': 'DB_PASSWORD',
'HOST': 'localhost', # Or an IP Address that your database is hosted on
'PORT': '3306',
#optional:
'OPTIONS': {
'charset' : 'utf8',
'use_unicode' : True,
'init_command': 'SET '
'storage_engine=INNODB,'
'character_set_connection=utf8,'
'collation_connection=utf8_bin'
#'sql_mode=STRICT_TRANS_TABLES,' # see note below
#'SESSION TRANSACTION ISOLATION LEVEL READ COMMITTED',
},
'TEST_CHARSET': 'utf8',
'TEST_COLLATION': 'utf8_general_ci',
}
}
Se si utilizza il connettore MySQL di Oracle, la linea ENGINE
dovrebbe avere il seguente aspetto:
'ENGINE': 'mysql.connector.django',
Quando crei un database, assicurati di specificare la codifica e le regole di confronto:
CREATE DATABASE mydatabase CHARACTER SET utf8 COLLATE utf8_bin
Da MySQL 5.7 in poi e su nuove installazioni di MySQL 5.6, il valore predefinito dell'opzione sql_mode contiene STRICT_TRANS_TABLES . Quell'opzione degrada gli avvisi in errori quando i dati vengono troncati al momento dell'inserimento. Django consiglia vivamente di attivare una modalità rigorosa per MySQL per prevenire la perdita di dati (STRICT_TRANS_TABLES o STRICT_ALL_TABLES). Per abilitare aggiungi a /etc/my.cnf
sql-mode = STRICT_TRANS_TABLES
PostgreSQL
Assicurati di avere alcuni pacchetti installati:
sudo apt-get install libpq-dev
pip install psycopg2
Impostazioni del database per PostgreSQL:
#myapp/settings/settings.py
DATABASES = {
'default': {
'ENGINE': 'django.db.backends.postgresql',
'NAME': 'myprojectDB',
'USER': 'myprojectuser',
'PASSWORD': 'password',
'HOST': '127.0.0.1',
'PORT': '5432',
}
}
Nelle versioni precedenti puoi anche usare l'alias django.db.backends.postgresql_psycopg2
.
Usando Postresql avrai accesso ad alcune funzionalità extra:
Modelfields:
ArrayField # A field for storing lists of data.
HStoreField # A field for storing mappings of strings to strings.
JSONField # A field for storing JSON encoded data.
IntegerRangeField # Stores a range of integers
BigIntegerRangeField # Stores a big range of integers
FloatRangeField # Stores a range of floating point values.
DateTimeRangeField # Stores a range of timestamps
sqlite
sqlite è l'impostazione predefinita per Django. Non dovrebbe essere usato in produzione poiché è solitamente lento.
#myapp/settings/settings.py
DATABASES = {
'default': {
'ENGINE': 'django.db.backends.sqlite3',
'NAME': 'db/development.sqlite3',
'USER': '',
'PASSWORD': '',
'HOST': '',
'PORT': '',
},
}
infissi
Le fixture sono dati iniziali per il database. Il modo più semplice quando si hanno già alcuni dati esistenti è usare il comando dumpdata
./manage.py dumpdata > databasedump.json # full database
./manage.py dumpdata myapp > databasedump.json # only 1 app
./manage.py dumpdata myapp.mymodel > databasedump.json # only 1 model (table)
Questo creerà un file json che può essere importato di nuovo usando
./manage.py loaddata databasedump.json
Quando si utilizza loadddata
senza specificare un file, Django cercherà una cartella fixtures
nella propria app o l'elenco delle directory fornite in FIXTURE_DIRS
nelle impostazioni e utilizzerà invece il suo contenuto.
/myapp
/fixtures
myfixtures.json
morefixtures.xml
I possibili formati di file sono: JSON, XML or YAML
Esempio JSON di Fixtures:
[
{
"model": "myapp.person",
"pk": 1,
"fields": {
"first_name": "John",
"last_name": "Lennon"
}
},
{
"model": "myapp.person",
"pk": 2,
"fields": {
"first_name": "Paul",
"last_name": "McCartney"
}
}
]
Esempio di YAML delle fixture:
- model: myapp.person
pk: 1
fields:
first_name: John
last_name: Lennon
- model: myapp.person
pk: 2
fields:
first_name: Paul
last_name: McCartney
Esempio XML Fixtures:
<?xml version="1.0" encoding="utf-8"?>
<django-objects version="1.0">
<object pk="1" model="myapp.person">
<field type="CharField" name="first_name">John</field>
<field type="CharField" name="last_name">Lennon</field>
</object>
<object pk="2" model="myapp.person">
<field type="CharField" name="first_name">Paul</field>
<field type="CharField" name="last_name">McCartney</field>
</object>
</django-objects>
Django Cassandra Engine
- Installa pip:
$ pip install django-cassandra-engine
- Aggiungi Introduzione a INSTALLED_APPS nel tuo file settings.py:
INSTALLED_APPS = ['django_cassandra_engine']
- Impostazione Cange DATABASES Standart:
Standart
DATABASES = {
'default': {
'ENGINE': 'django_cassandra_engine',
'NAME': 'db',
'TEST_NAME': 'test_db',
'HOST': 'db1.example.com,db2.example.com',
'OPTIONS': {
'replication': {
'strategy_class': 'SimpleStrategy',
'replication_factor': 1
}
}
}
}
Cassandra crea un nuovo utente cqlsh:
DATABASES = {
'default': {
'ENGINE': 'django_cassandra_engine',
'NAME': 'db',
'TEST_NAME': 'test_db',
'USER_NAME'='cassandradb',
'PASSWORD'= '123cassandra',
'HOST': 'db1.example.com,db2.example.com',
'OPTIONS': {
'replication': {
'strategy_class': 'SimpleStrategy',
'replication_factor': 1
}
}
}
}