Django
Datenbank-Setup
Suche…
MySQL / MariaDB
Django unterstützt MySQL 5.5 und höher.
Stellen Sie sicher, dass einige Pakete installiert sind:
$ 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
Neben einem der Python MySQL-Treiber ( mysqlclient
ist die empfohlene Wahl für Django):
$ pip install mysqlclient # python 2 and 3
$ pip install MySQL-python # python 2
$ pip install pymysql # python 2 and 3
Die Datenbankkodierung kann nicht von Django festgelegt werden, muss jedoch auf Datenbankebene konfiguriert werden. Suchen Sie in my.cnf (oder
/etc/mysql/mariadb.conf/*.cnf
) nach demdefault-character-set
und legen Sie die Kodierung fest:
[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
Datenbankkonfiguration für MySQL oder 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',
}
}
Wenn Sie den MySQL-Connector von Oracle verwenden, sollte Ihre ENGINE
Zeile folgendermaßen aussehen:
'ENGINE': 'mysql.connector.django',
Stellen Sie beim Erstellen einer Datenbank sicher, dass Kodierung und Sortierung angegeben werden:
CREATE DATABASE mydatabase CHARACTER SET utf8 COLLATE utf8_bin
Ab MySQL 5.7 und bei Neuinstallationen von MySQL 5.6 enthält der Standardwert der Option sql_mode STRICT_TRANS_TABLES . Diese Option führt zu Warnungen, wenn die Daten beim Einfügen abgeschnitten werden. Django empfiehlt dringend, einen strikten Modus für MySQL zu aktivieren, um Datenverlust zu vermeiden (entweder STRICT_TRANS_TABLES oder STRICT_ALL_TABLES). Zum Aktivieren von hinzufügen zu /etc/my.cnf
sql-mode = STRICT_TRANS_TABLES
PostgreSQL
Stellen Sie sicher, dass einige Pakete installiert sind:
sudo apt-get install libpq-dev
pip install psycopg2
Datenbankeinstellungen für 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',
}
}
In älteren Versionen können Sie auch den Alias django.db.backends.postgresql_psycopg2
.
Wenn Sie Postresql verwenden, haben Sie Zugriff auf einige zusätzliche Funktionen:
Modelfelder:
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 ist die Standardeinstellung für Django. Es sollte nicht in der Produktion verwendet werden, da es normalerweise langsam ist.
#myapp/settings/settings.py
DATABASES = {
'default': {
'ENGINE': 'django.db.backends.sqlite3',
'NAME': 'db/development.sqlite3',
'USER': '',
'PASSWORD': '',
'HOST': '',
'PORT': '',
},
}
Fixtures
Fixtures sind Anfangsdaten für die Datenbank. Wenn Sie bereits einige Daten haben, können Sie am einfachsten den Befehl 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)
Dadurch wird eine Json-Datei erstellt, die mit erneut importiert werden kann
./manage.py loaddata databasedump.json
Wenn Sie loadddata
ohne eine Datei anzugeben, sucht Django nach einem fixtures
Ordner in Ihrer App oder der Liste der Verzeichnisse in den FIXTURE_DIRS
Einstellungen und verwendet stattdessen dessen Inhalt.
/myapp
/fixtures
myfixtures.json
morefixtures.xml
Mögliche Dateiformate sind: JSON, XML or YAML
Fixtures JSON-Beispiel:
[
{
"model": "myapp.person",
"pk": 1,
"fields": {
"first_name": "John",
"last_name": "Lennon"
}
},
{
"model": "myapp.person",
"pk": 2,
"fields": {
"first_name": "Paul",
"last_name": "McCartney"
}
}
]
Fixtures YAML Beispiel:
- model: myapp.person
pk: 1
fields:
first_name: John
last_name: Lennon
- model: myapp.person
pk: 2
fields:
first_name: Paul
last_name: McCartney
XML-Beispiel für 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
-
$ pip install django-cassandra-engine
:$ pip install django-cassandra-engine
- Fügen Sie "Erste Schritte" zu INSTALLED_APPS in Ihrer Datei
INSTALLED_APPS = ['django_cassandra_engine']
:INSTALLED_APPS = ['django_cassandra_engine']
- Cange DATABASES Einstellung 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 neuen Benutzer cqlsh erstellen:
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
}
}
}
}