プログラミングマガジン

プログラミングを中心にIT技術をできるだけわかりやすくまとめます。

  • ホーム
  • Hasura
  • 【Hasura】「Migrations」&「Metadata」について
 
 
     
  • サーバー言語  
    • Python
    • Ruby
    • PHP
    • SQL
  •  
  • インフラ  
       
    • AWS
    •  
    • 基本
    • Git
  • Web
       
    • Web開発
    • JavaScript
    • Vue.js
    • React
  •  
  • 設計  
       
    • 実装設計
    • DB設計
  • 問い合わせ
  

【Hasura】「Migrations」&「Metadata」について

10.16

  • miyabisan2
  • コメントを書く

この記事は2分で読めます

Migrations、Metadataとは?

DBのスキーマやHasuraのメタデータをファイルとして出力でき、これを使用して全く別環境に類似環境の構築が可能。

出力したファイルは編集することで環境のカスタマイズが可能

各時点でのスキーマやメタデータをバージョン管理するので環境をロールバックすることも可能。

メタデータとは?

メタデータの中には以下の内容が含まれています。

  • テーブルやVIEW
  • Action
  • スキーマ登録内容
  • リレーションの情報など

手順

Hasura CLIのインストール

Hasura CLIを自分のPCにインストールします。

Hasuraのmetadataなどを作る。

1
hasura init

metadataディレクトリ

hasura metadataファイルです。まだ構築したばかりの時はファイルはたくさんありますが中身がほぼ空の状態になります。テーブルの構造情報ではなくHasuraに対してテーブルの存在をtrackさせる役割です。

migrationsディレクトリ

database migrationファイルが保持されます。これはHasuraが裏側のPostgreSQLに対して実行したDDL(create文など)そのものになります。なので、これを別DBに実行すれば全く同じ状態のテーブルを再現できます。

移行の初期化

1
hasura migrate create init --from-server

すると、「hasura/migrations」配下に「up.sql」という移行用のSQLファイルが生成されます。

metadataのエクスポート

1
hasura metadata export

metadataフォルダ配下にyamlファイルが生成されます。

metadataとデータベーススキーマ情報をhasuraデータベースと同期させる

1
2
hasura metadata apply # metadata
hasura migrate apply # migrate

metadataの情報をHasuraに反映させます。

例えば、ローカルのdockerでHasuraを動作させている場合はdocker-compose downすればdockerインスタンスの情報が全てリセットされるので再度docker-compose upした時はHasuraの情報が消えることになりますが、metadataさえ保持していればこのコマンドを実行した際にHasuraに再度trackさせて反映させることができます。

注意点

この手順ではテーブルの中身は復元できません。もし復元したい場合はseedなどを使います。

便利コマンド

現在のhasuraの構成バージョンを見る。

1
hasura migrate status

Hasuraのリアルタイムコンソールを立ち上げる。

1
hasura console

Hasuraのコンソールが立ち上がります。注意点としては通常の8080で立ち上げるコンソールと違ってGUIでテーブルをいじるたびに自動でmigrationファイル(up、downなど)が生成される点です。また、metadataの中身もリアルタイムに変わります。(例えばテーブルを作成したらtablesディレクトリに新しいyamlファイルが出力されます。

スポンサーリンク
  • 2022 10.16
  • miyabisan2
  • コメントを書く
  • Hasura
  • Tweets Twitter
  • このエントリーをはてなブックマークに追加
  • LINEで送る

関連記事

  1. 2022 10.09

    【Firebase】「Cloud Function」と「Hasura」の連携

  2. 2022 10.08

    【Next.js】「Hasura」と「Apollo Client」の連携

  3. 2022 10.09

    【Hasura】テーブルの設定(「リレーションシップ」、「Permissions」)について

  4. 2022 10.16

    【Hasura】基本、Railsとの連携

  5. 2022 10.09

    【Hasura】認証方式(「Hasura admin secret」、「JWT認証」など)について

  • コメント ( 0 )
  • トラックバック ( 0 )
  1. この記事へのコメントはありません。

  1. この記事へのトラックバックはありません。

返信をキャンセルする。

【Hasura】基本、Railsとの連携

【AWS】IAMの「AssumeRole(アシュームロ…

RETURN TOP

著者プロフィール

エンジニア歴10年で過去に業務系、Webデザイン、インフラ系なども経験あります。現在はWeb系でフロントエンド開発中心です。

詳細なプロフィールはこちら

スポンサーリンク

カテゴリー

  • Android
  • AngularJS
  • API
  • AWS
  • C++
  • CSS
  • C言語
  • DDD
  • DevOps
  • Django
  • Docker
  • Figma
  • Git
  • GitLab
  • GraphQL
  • gRPC
  • Hasura
  • Java
  • JavaScript
  • Kubernetes
  • Laravel
  • linux
  • MySQL
  • Next.js
  • nginx
  • Node.js
  • NoSQL
  • Nuxt.js
  • Oracle
  • PHP
  • Python
  • React
  • Redux
  • Rspec
  • Ruby
  • Ruby on Rails
  • Sass
  • Spring Framework
  • SQL
  • TypeScript
  • Unity
  • Vue.js
  • Webサービス開発
  • Webデザイン
  • Web技術
  • インフラ
  • オブジェクト指向
  • システム開発
  • セキュリティ
  • その他
  • データベース
  • デザインパターン
  • テスト
  • ネットワーク
  • プログラミング全般
  • マイクロサービス
  • マイクロソフト系技術
  • マルチメディア
  • リファクタリング
  • 副業
  • 未分類
  • 業務知識
  • 生成AI
  • 設計
  • 関数型言語
RETURN TOP

Copyright ©  プログラミングマガジン | プライバシーポリシー