更新日: 2016年2月2日
MySQL & DB

MySQLでBLOB/TEXT型のカラムにはデフォルト値を設定できない

CakePHP 3 開発のマイグレーションで、MySQL データベースの TEXT 型のカラムにデフォルト値を設定しようとして遭遇したエラー。


BLOB/TEXT column 'description' can't have a default value

BLOB/TEXT column 'description' can't have a default value

— 環境 —
PHP 5.5.19
CakePHP 3.1.1
MySQL 5.6.19

【お知らせ】英単語を画像イメージで楽に暗記できる辞書サイトを作りました。英語学習中の方は、ぜひご利用ください！

画像付き英語辞書 Imagict | 英単語をイメージで暗記
【開発記録】
英単語を画像イメージで暗記できる英語辞書サービスを作って公開しました

MySQLはBLOB/TEXT型のカラムにデフォルト値を設定できない

CakePHP の bin/cake bake コマンドを使って…


$ bin/cake bake migration CreateProducts description:text ...

$ bin/cake bake migration CreateProducts description:text ...

のように、マイグレーション用ファイルを生成したところ、以下のファイルが生成された。

config/Migrations/*****_create_products.php

<?php
use Migrations\AbstractMigration;

class CreateProducts extends AbstractMigration
{
    /**
     * Change Method.
     *
     * More information on this method is available here:
     * http://docs.phinx.org/en/latest/migrations.html#the-change-method
     * @return void
     */
    public function change()
    {
        $table = $this->table('products');
        // ...
        $table->addColumn('description', 'text', [
            'default' => '',
            'null' => false,
        ]);
        // ...
    }
}

<?php

use Migrations\AbstractMigration;

class CreateProducts extends AbstractMigration

{

/**

* Change Method.

* More information on this method is available here:

* http://docs.phinx.org/en/latest/migrations.html#the-change-method

* @return void

public function change()

{

$table = $this->table('products');

// ...

$table->addColumn('description', 'text', [

'default' => '',

'null' => false,

]);

// ...

}

これをそのままマイグレーションを実行してみましたら…

$ bin/cake migrations migrate

1	$ bin/cake migrations migrate

以下のエラーメッセージが表示されてマイグレーションが失敗。


Syntax error or access violation: 1101 BLOB/TEXT column 'description' can't have a default value

Syntax error or access violation: 1101 BLOB/TEXT column 'description' can't have a default value

デフォルト値（’default’ => ”）の指定を削除

どうやら MySQL の仕様で、データ型が BLOB または TEXT 型のカラムにはデフォルト値を設定することができないらしい。

なので、該当部分を以下のように修正してマイグレートやり直し。

config/Migrations/*****_create_products.php

$table->addColumn('description', 'text');

1	$table->addColumn('description', 'text');

マイグレートを再び実行。


$ bin/cake migrations migrate

$ bin/cake migrations migrate

これで、無事にマイグレーションが成功した。

“bin/cake bake migration” コマンドで自動生成されたマイグレーションファイルを使うときは、ちょっと注意が必要ですね。

現場で使えるMySQLは長くお世話になっていて、MySQL触る人には必須の本。

現場で使える MySQL (DB Magazine SELECTION)

PHP+MySQLマスターブック

<< 前の記事 : SQLite3でDBテーブルをdumpバックアップ

MySQLでBLOB/TEXT型のカラムにはデフォルト値を設定できない

MySQLはBLOB/TEXT型のカラムにデフォルト値を設定できない

デフォルト値（’default’ => ”）の指定を削除

Leave Your Message! コメントをキャンセル