Create-one-table.md

How to create one table

目標

用 DB Browser 的 execute SQL 功能，做出如同在 EF Core 建立的 table 。

• How to create one table

  • 這個 table 的主要結構如下：

    public class EnglishVocabularyNote
    {
    
      // 只有一個 table 要加上 [key] 標示，不然 EF 會不知道哪一個是 primary key 或是 根本沒有 primary key 。
      // [key] 預設是自動產生，從 1 開始。
    
      [Key] 
      public int NoteId { get; set; }
      public string Word { get; set; }
      public string MeaningInChinese { get; set; }
    }

  • 填入的資料為：

    // 1、tweezers : 鑷子
    // 2、clothespin : 洗衣夾
    // 3、clothesline : 曬衣繩

預備

準備 SQL 語法（非必要）

• 可以使用 GUI 介面建立 table ，然後觀察 DB Browser Application log 是怎麼寫的 😆

  注意 ： DB Browser 的 log 會把 資料表名稱、欄位名稱......加上 "" ， SQL 語法不需要加上 "" ，但 execute SQL無論是否有 "" 都可以被接受。

執行

1. New Database > 命名檔案 > 儲存 。（快捷鍵： ctrl + N）

   • 或是建造一個 In-Memory 的檔案，關閉檔案後資料即消失。

2. 點擊頁籤 execute SQL 。

3. 建立資料表，打完後按圖示 ▶ 或是 快捷鍵：ctrl + R ，之後的步驟都是如此。

    CREATE TABLE EnglishVocabularyNote(
    NoteId INTEGER,
    Word TEXT NOT NULL,
    MeaningInChinese TEXT NOT NULL,
    PRIMARY KEY(NoteId)
    )

4. 填入資料：

    INSERT INTO EnglishVocabularyNote
    VALUES(1, 'tweezers', '鑷子'),
    (2, 'clothespin','洗衣夾'),
    (3, 'clothesline', '曬衣繩')

   • 2022/02/15 檢討 ： 如果我想要在 NoteId 填入從 1 開始往下遞增的整數，其實 也 可以不用特地給 NoteId ，但是需要在 SQL 語法中指定欄位。

     • 請見 Auto increment primary key

驗證

1. 把 table 裡的資料調出來：

    SELECT * FROM EnglishVocabularyNote

2. 呈現結果：

   --	NoteId	Word	MeaningInChinese
   1	1	tweezers	鑷子
   2	2	clothespin	洗衣夾
   3	3	clothesline	曬衣繩

2022/02/14 檢討

Why

在 INSERT INTO 時特別指定欄位，這樣可以確保資料表欄位被變動（而你不知情）時，儲存正確的資料。

if you ever add, move, or delete columns in your table definition the INSERT will either fail or produce incorrect data (with the values in the wrong columns).

Is there an auto increment in sqlite?

How

我們為這個資料表加上一筆新資料：

INSERT INTO EnglishVocabularyNote (NoteId, Word, MeaningInChinese)
VALUES (4, 'keychain', '鑰匙圈')

Verify

1. 看是否儲存成功：

   SELECT * FROM EnglishVocabularyNote WHERE NoteId = 4

   結果：

   --	NoteId	Word	MeaningInChinese
   1	4	keychain	鑰匙圈

What if...?

1. 毀滅的情境：欄位與資料不符

   INSERT INTO EnglishVocabularyNote 
   VALUES (4, 'rubber band', '橡皮筋', '來鬧的')

   結果：

   Execution finished with errors.
   Result: table EnglishVocabularyNote has 3 columns but 4 values were supplied
   At line 1:
   INSERT INTO EnglishVocabularyNote 
   VALUES (4, 'rubber band', '橡皮筋', '來鬧的')

2. 毀滅的情境：資料錯置

   INSERT INTO EnglishVocabularyNote 
   VALUES (5, '杯墊', 'coaster')

   SELECT * FROM EnglishVocabularyNote WHERE NoteId = 5

   結果：

   --	NoteId	Word	MeaningInChinese
   1	5	杯墊	coaster