Django
データベースのセットアップ
サーチ…
MySQL / MariaDB
DjangoはMySQL 5.5以上をサポートしています。
いくつかのパッケージがインストールされていることを確認してください:
$ 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
Python MySQLドライバの1つ( mysqlclient
はDjangoの推奨選択肢です):
$ pip install mysqlclient # python 2 and 3
$ pip install MySQL-python # python 2
$ pip install pymysql # python 2 and 3
データベースエンコーディングはDjangoで設定することはできませんが、データベースレベルで設定する必要があります。 my.cnf(または
/etc/mysql/mariadb.conf/*.cnf
)でdefault-character-set
を探し、エンコーディングを設定します。
[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
MySQLまたは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',
}
}
OracleのMySQLコネクタを使用している場合、 ENGINE
行は次のようになります。
'ENGINE': 'mysql.connector.django',
データベースを作成するときは、エンコードと照合を指定する必要があります。
CREATE DATABASE mydatabase CHARACTER SET utf8 COLLATE utf8_bin
MySQL 5.7以降および新しくインストールされたMySQL 5.6では、sql_modeオプションのデフォルト値にはSTRICT_TRANS_TABLESが含まれています 。このオプションは、挿入時にデータが切り捨てられた場合、警告をエラーにエスカレートします。 Djangoは、データ損失(STRICT_TRANS_TABLESまたはSTRICT_ALL_TABLESのいずれか)を防ぐために、MySQLの厳密モードを有効にすることを強く推奨します。 /etc/my.cnfへの追加を有効にするには
sql-mode = STRICT_TRANS_TABLES
PostgreSQL
いくつかのパッケージがインストールされていることを確認してください:
sudo apt-get install libpq-dev
pip install psycopg2
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',
}
}
古いバージョンでは、別名django.db.backends.postgresql_psycopg2
使用することもできます。
Postresqlを使用する場合、いくつかの追加機能にアクセスできます:
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はDjangoのデフォルトです。 通常は遅いため、本番環境では使用しないでください。
#myapp/settings/settings.py
DATABASES = {
'default': {
'ENGINE': 'django.db.backends.sqlite3',
'NAME': 'db/development.sqlite3',
'USER': '',
'PASSWORD': '',
'HOST': '',
'PORT': '',
},
}
備品
フィクスチャは、データベースの初期データです。既存のデータをすでに持っているときに最も簡単な方法は、 dumpdata
コマンドを使うこと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)
これにより、jsonファイルが作成されます。このファイルは、
./manage.py loaddata databasedump.json
ファイルを指定せずにloadddata
を使用する場合、Djangoはアプリケーション内のfixtures
フォルダまたはFIXTURE_DIRS
設定で提供されるディレクトリのリストをFIXTURE_DIRS
、代わりにそのコンテンツを使用します。
/myapp
/fixtures
myfixtures.json
morefixtures.xml
可能なファイル形式はJSON, XML or YAML
備品JSONの例:
[
{
"model": "myapp.person",
"pk": 1,
"fields": {
"first_name": "John",
"last_name": "Lennon"
}
},
{
"model": "myapp.person",
"pk": 2,
"fields": {
"first_name": "Paul",
"last_name": "McCartney"
}
}
]
備品YAMLの例:
- 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の例:
<?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>
ジャンゴカサンドラエンジン
- インストールpip:
$ pip install django-cassandra-engine
- settings.pyファイルのINSTALLED_APPSへの開始を追加:
INSTALLED_APPS = ['django_cassandra_engine']
- Cangeデータベースの設定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は新しいユーザー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
}
}
}
}