ワークスペースとGitリポジトリの統合¶
重要
2025年9月から、Snowflakeは徐々にアカウントをワークシートからワークスペースにアップグレードします。ワークスペースがデフォルトの SQL エディターになります。詳細については、 アカウントのデフォルト設定をワークシートからワークスペースに変更 をご参照ください。
概要¶
ワークスペースはSnowflakeのローカルに置くこともできますし、開発中のワークスペースをGitリポジトリのブランチと同期させることもできます。ワークスペースでは、次のことができます。
Gitリポジトリから最新の変更をワークスペースに取り込みます。
コミットし、更新したファイル をGit リポジトリにプッシュします。
ワークスペースで直接、コンフリクト を表示し、解決します。
Gitワークスペースの作成¶
Snowsight で直接ファイルを開発・管理するには、Gitリポジトリに接続したワークスペースを作成します。
注釈
Gitリポジトリには少なくとも1つのブランチが含まれている必要があります。空のリポジトリはサポートされていません。
新しいGit同期ワークスペースを作成するには、以下の手順に従ってください。
Snowsight にサインインします。
ナビゲーションメニューで Projects » Workspaces を選択します。
Workspaces メニューで、 From Git repository を選択します。
Git リポジトリから URL をコピーし（たとえば
https://www.github.com/my-user/my-repo-name）、 Repository URL フィールドに貼り付けます。オプション: 新しいGit同期ワークスペースの名前を変更します。
API Integration メニューで、 API 統合.を選択します。
API 統合は、ステップ4で使用したGitリポジトリ URL へのアクセスを許可する必要があります。API 統合の作成には CREATEAPIINTEGRATION 権限が必要です。これは多くのアカウントの管理者ロールに制限されていることがよくあります。別のロールが API 統合を作成した場合、現在のロールにはその API 統合の USAGE 権限が必要です。
Select an authentication method:
OAuth2 : 認証に OAuth2 を使用するには、Gitプロバイダーで OAuth をサポートするように API 統合を構成する必要があります。詳細については、 Gitを使用するためのSnowflakeの設定 をご参照ください。次の手順を完了します。
GitHub リポジトリで認証するには、 Sign in を選択します。
使用するアカウントの横にある Configure を選択し、次に Snowflake Computing の隣にある Authorize を選択して、
snowflakedbアプリがリポジトリにアクセスできるようにします。Permissions の下で、リポジトリへの変更をプルおよびプッシュできるように、 Read access to metadata および Read and write access to code 権限が付与されていることを確認します。
Repository access の下で、Snowflakeに付与するアクセスのレベルを指定します。
Select Save.
詳細については、 `OAuth アプリアクセス<https://docs.github.com/en/apps/oauth-apps/using-oauth-apps/authorizing-oauth-apps#oauth-app-access>`_ をご参照ください。承認された管理者がアプリを承認すると、そのアカウントのすべてのユーザーがアプリを使用できるようになります。
Personal access token - トークンを含むオブジェクトが格納されているデータベースとスキーマを選択します。新しい秘密を作成するには、 + Secret を選択し、必要な詳細を入力します。このシークレットまたはすべてのシークレットへのアクセスを許可するように API 統合を構成する必要があります。
Public repository - 認証を必要としない公開リポジトリを使用している場合は、このオプションを選択します。ワークスペースの変更をコミットして、この公開リポジトリにプッシュすることはできません。
Create を選択します。
新しいブランチの作成¶
現在のブランチから新しいブランチを作成して、単独で変更作業を行うことができます。
Snowsight にサインインします。
ナビゲーションメニューで Projects » Workspaces を選択します。
Changes タブを選択します。
リポジトリのドロップダウンを選択します。
+ New を選択します。
新しいブランチ名を指定し、 Create を選択します。
別の支店に変更¶
保存はしたもののコミットしていない変更がある場合、ブランチを切り替える前にその変更をどのように扱うかを選択する必要があります。
Snowsight にサインインします。
ナビゲーションメニューで Projects » Workspaces を選択します。
Git ワークスペース表示で、 Changes を選択します。
ブランチメニューから、切り替えたいブランチを選択します。
Tip
リストを絞り込むには、ブランチ名の入力を開始します。
リモートブランチの取得¶
新しいブランチが Snowsight の外部 (たとえば Git プロバイダーで作成したものなど) で作成された場合は、 Fetch All オプションを使用して Git と同期したワークスペースに取り込むことができます。これで利用可能なリモートブランチのリストが更新されます。
Snowsight にサインインします。
ナビゲーションメニューで Projects » Workspaces を選択します。
Git ワークスペース表示で、 Changes を選択します。
Pull メニューの横にある下向き矢印を選択し、 Fetch All を選択します。取得が終了すると、新しく作成されたリモートブランチがブランチリストに表示され、チェックアウトが可能になります。
更新されたファイルの表示¶
最後にコミットとプッシュに成功してから追加、削除、変更されたすべてのファイルを表示するには、以下の手順に従います。
Snowsight にサインインします。
ナビゲーションメニューで Projects » Workspaces を選択します。
フォルダ表示の上部で、 Changes を選択します。変更されたファイルは M で示され、追加されたファイルは A で示され、削除されたファイルは D で示されます。
エディタで変更点の差分を視覚的に表示するには、ファイルを選択します。
更新のコミットとプッシュ¶
変更内容を確認したら、ワークスペース内からコミットしてリモートの Git リポジトリにプッシュします。
更新したファイルをコミットしてリモートのGitリポジトリにプッシュするには、以下の手順に従います。
Snowsight にサインインします。
ナビゲーションメニューで Projects » Workspaces を選択します。
フォルダ表示の上部にある Changes を選択します。
Commit message フィールドにコミットメッセージを書いてください。
Push を選択します。
コミットメッセージを書き、 Push を選択して Git リポジトリに更新をプッシュします。
注釈
コンフリクトが検出された場合、最初にプルするよう促されます。コンフリクトのあるファイルのリストを確認するには、 Pull を選択します。
コンフリクトの表示と解決¶
プッシュ中にコンフリクトが発生した場合、再度コミットする前にワークスペースで直接表示し、解決することができます。
ワークスペースで、フォルダ表示の上部にある Changes を選択します。1つまたは複数のファイルが競合している場合、メッセージが表示の上部に表示されます。競合のあるファイルは、赤い M で示されます。
エディターでコンフリクトの差分を表示するには、ファイルを選択します。File with conflicts では、相違点はインラインで強調表示されます。
現在の変更、入力された変更、または両方の変更を受け入れます。マージ結果が表示されます。
Diff View の下に、現在のバージョンとリモートバージョンを並べて表示することができます。
Accept all current または Accept all remote を選択します。
競合を解決したら、 Push を選択します。
コミットメッセージを書いてください。
Push を選択します。