Pi's Blog

前言

在設計資料庫結構時，常常會用到 id 的概念
id 主要用來辨認資料
因此它的唯一性是很重要的

之前我在定義postgre資料庫的 id 欄位時，
是直接設為 PK (在 Flask_SQLAlchemy 中 PK 預設 auto increment)

這樣有個小缺點是
id 好猜，且會反映各資料間的先後關係
但 id 並不會作為排序依據
所以我認為並不適合做整數自動遞增

不過好處是 api endpoint 不會太難看XD
但應該沒什麼人會在意 endpoint 啦

UUID vs GUID

查資料的過程中我看到這兩個詞

• UUID (Universally Unique Identifier) 通用唯一辨識碼

• GUID (Globally Unique Identifier) 全域唯一辨識碼

UUID是在分散式計算環境(Distributed Computing Environment, DCE)下
確保 ID 不重複的一個規範
而 GUID 則是由微軟設計的 UUID 應用
編碼方式有所不同

UUID格式：xxxxxxxx-xxxx-xxxx-xxxxxxxxxxxxxxxx (8-4-4-16)

GUID格式：xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx (8-4-4-4-12)

總而言之

GUID 可以視為 UUID 的一個變體
是微軟基於 UUID 再加上一些自己的方法做出來的 ID

那麼…哪裡才能買的到呢?

不用買，各平台都有實作 UUID 的套件了
以我在用的 JS 來說
可以用這個 npm 的 uuid

使用方法很簡單

1

npm install uuid

1
2
3

import uuid from 'uuid'

uuid.v4() // 生成一組 uuid

最後補充一下這裡的v4是什麼意思(取自wiki)

版本1 - UUID 是根據時間和節點ID（通常是MAC位址）生成；

版本2 - UUID 是根據識別碼（通常是組或使用者ID）、時間和節點ID生成；

版本3、版本5 - 確定性UUID 通過雜湊（hashing）命名空間（namespace）識別碼和名稱生成；

版本4 - UUID 使用隨機性或偽隨機性生成。

基本上就是不同的產生方式，但我覺得大部分情況都用同一種就可以了~

前言

有件事一直搞不懂
我在看 heroku postgres 要怎麼備份時
看到有些範例會寫 –app 來指定 app 名稱
如: heroku pg:backups:capture --app sushi

看起來好像是必要的參數
但有時範例又沒有加

尋找答案

先看help

help flag 永遠是第一步
所以我輸入 heroku pg:backups --help 求解，得到

1
2
3

OPTIONS
  -a, --app=app        (required) app to run command against
  -r, --remote=remote  git remote of app to use

哦! 他說 required
但實際運行 heroku pg:backups 的時候
卻又沒問題

試試跟 app 有關的指令

於是接下來，我運行 heroku apps 得到

1
2
3

=== *******@yahoo.com.tw Apps
pi-first-api
taiwan-astronomy-network-api

沒錯
目前我的帳號有這兩個app
pi-first-api是我第一次使用heroku時的練習app
taiwan-astronomy-network-api這是我正在用的app
我輸入指令沒指定app
heroku卻知道我要使用哪個app
這可能代表我之前有做過什麼設定
讓heroku在「目前的資料夾當中」自動連結到正確的app上

是否只有此路徑能自動指定app?

為了證實剛剛的假設
我移動到上層資料夾(不在專案內)
執行 heroku pg:backups
居然跳出錯誤訊息!

1
2
3

»   Error: Missing required flag:
»     -a, --app APP  app to run command against
»   See more help with --help

所以現在確定了
只有在我的專案資料夾才能夠省略 –app

這時我突然想到
在當初第一次使用 heroku 的時候
有做了一些前置作業
其中包含了指定 remote
很有可能就是這個原因

1
2
3
4
5

> git remote -v
heroku  https://git.heroku.com/taiwan-astronomy-network-api.git (fetch)
heroku  https://git.heroku.com/taiwan-astronomy-network-api.git (push)
origin  https://github.com/roto93/TAN-API.git (fetch)
origin  https://github.com/roto93/TAN-API.git (push)

後來我也試著把 remote 去掉再試一次，這樣就不行了
看來可以確定主因了

結論

若專案資料夾有設定 heroku 的 remote
那在輸入 heroku 指令時就不需要加上 –app 的 flag

參考

前言

這裡記錄一些 Heroku Postgres 常用的指令

由於我不算主攻資料庫，這些指令頂多在建立API時才會用到
真的很容易忘記
為自己做點紀錄，不用每次都去翻 doc
這篇文章會持續更新

SQL 語法

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

-- 新建資料庫
CREATE DATABASE name;

-- 更改資料庫名稱
ALTER DATABASE <name> RENAME TO <newname>


-- 刪除整個資料表
DROP TABLE table_name; 

-- 刪除資料表中的內容，但保留資料表
TRUNCATE TABLE table_name;

-- 刪除整個資料庫
DROP DATABASE database_name;

--顯示某 table 的所有欄位
SELECT column_name 
 FROM information_schema.columns 
 WHERE table_name = 'table_issues' 
 AND table_schema = 'public';

遠端 heroku postgres 操作

• 查看現有備份檔
  heroku pg:backups

• 立刻建立備份
  (指定app) heroku pg:backups:capture --app taiwan-astronomy-network-api
  (指定database) heroku pg:backups:capture table_issues

• 排程備份
  heroku pg:backups:schedule --at "06:00 Asia/Taipei"
  flag –at 是必需參數，格式為: “hour:00 full TZ format“
  Windows 必須使用雙引號
  Full TZ format 查詢: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones

• 查看排程
  heroku pg:backups:schedules

• 取消排程
  heroku pg:backups:unschedule DATABASE_URL
  DATABASE_URL: 如果一個 APP 有多個 DATABASE，則需指定 DATABASE 的 URL

• 下載備份
  heroku pg:backups:download BACKUP_ID -o OUTPUT_NAME
  BACKUP_ID: 要下載的備份檔id，可先用 heroku pg:backups 查詢
  OUTPUT_NAME: 輸出的路徑與檔名，預設為 latest.dump，但如果沒有設定的話不會覆寫同名檔案，而是變成latest.demp.1

本地 postgres 操作

• 用 latest.dump 復原本地資料庫
  pg_restore --verbose --clean --no-acl --no-owner -h localhost -U postgres -d tan_data latest.dump