正式なドキュメントは英語版であり、この日本語訳はAI支援翻訳により作成された参考用のものです。日本語訳の一部の内容は人間によるレビューがまだ行われていないため、翻訳のタイミングにより英語版との間に差異が生じることがあります。最新かつ正確な情報については、英語版をご参照ください。
ドキュメントに関する現在のご利用体験についてお聞かせください。アンケートにご協力ください

GitLab Orbit Localスキーマ参照

  • プラン: Free、Premium、Ultimate
  • 提供形態: GitLab.com、GitLab Self-Managed、GitLab Dedicated
  • ステータス: ベータ版

GitLab Orbit Localスキーマ参照は、利用可能なノード、エッジ、およびローカルグラフ内のリレーションシップを定義します。

ソースコードノード

以下のセクションでは、利用可能なノードとそのプロパティを定義します。

Directory

インデックス付けされたリポジトリ内のディレクトリ。

プロパティ定義
idディレクトリの固有識別子
project_idインデックス付けされたリポジトリの識別子で、絶対パスから導出されます。GitLabプロジェクトIDではありません。
branchディレクトリがインデックス付けされたブランチ
commit_shaディレクトリがインデックス付けされたコミット
pathリポジトリのルートディレクトリに対するパス
nameディレクトリ名

File

インデックス付けされたリポジトリ内のソースコードファイル。

プロパティ定義
idファイルの固有識別子
project_idインデックス付けされたリポジトリの識別子で、絶対パスから導出されます。GitLabプロジェクトIDではありません
branchファイルがインデックス付けされたブランチ
commit_shaファイルがインデックス付けされたコミット
pathリポジトリのルートディレクトリに対するパス
name拡張子を含むファイル名
extension先頭のドットを除いたファイル拡張子
language検出されたプログラミング言語、一致する言語がない場合はunknown
size_bytesファイルがインデックス付けされたときに測定した、バイト単位のファイルサイズ
reasonskip_excluded_extensionfault_invalid_utf8など、ファイルがスキップされた、または解析に失敗した理由。ファイルが正常に解析された場合は空。

Definition

ファイルで宣言された関数、クラス、メソッド、モジュール、またはその他の名前付きシンボル。

プロパティ定義
id定義の固有識別子で、ファイルパスごとに生成されます。2つのインデックス付けされたリポジトリ内の同じ関数は、異なるIDを持ちます。
project_idインデックス付けされたリポジトリの識別子で、絶対パスから導出されます。GitLabプロジェクトIDではありません。
branch定義がインデックス付けされたブランチ
commit_sha定義がインデックス付けされたコミット
file_path定義を宣言するファイルのパス
fqn関数、クラス、モジュール、メソッド、構造、enum、またはトレイトの完全修飾名
nameネームスペース修飾を含まない短縮名
definition_typeClassFunctionMethodStructなど、定義の種類。値は先頭が大文字で、言語固有です。
start_line定義の最初の行
end_line定義の最後の行
start_byte定義が開始するバイトオフセット
end_byte定義が終了するバイトオフセット
start_charstart_line上で定義が開始するカラム
end_charend_line上で定義が終了するカラム
search_textfqnfile_pathから抽出された小文字の識別子トークン。ランク付けされたコード検索に使用されます
token_countsearch_text内のトークン数

ImportedSymbol

ファイル内のインポートステートメント、またはファイル間のシンボル参照。

プロパティ定義
idインポートされたシンボルの固有識別子
project_idインデックス付けされたリポジトリの識別子で、絶対パスから導出されます。GitLabプロジェクトIDではありません。
branchシンボルがインデックス付けされたブランチ
commit_shaシンボルがインデックス付けされたコミット
file_pathインポートを含むファイルのパス
import_typeUseNamedImportCjsRequireなど、インポートの種類。値は先頭が大文字で、言語固有です。
import_pathシンボルのインポート元のモジュールまたはパス
identifier_nameインポートされたシンボルの名前。ワイルドカードインポートおよび副作用インポートの場合は空。
identifier_aliasインポートがシンボルをバインドするローカル名。アナライザーが何も記録しない場合は空。一部の言語では、インポートがリネームされていなくても、それが入力されます。
start_lineインポートの最初の行
end_lineインポートの最後の行
start_byteインポートが開始するバイトオフセット
end_byteインポートが終了するバイトオフセット
start_charstart_line上の、インポートが開始するカラム
end_charend_line上の、インポートが終了するカラム

リレーションシップ

ローカルグラフ内のエッジには、以下のリレーションシップタイプがあります:

  • CONTAINS
  • DEFINES
  • IMPORTS
  • CALLS
  • EXTENDS

同じリレーションシップタイプで異なるノードタイプを接続できます。

リレーションシップタイプソースノードターゲットノード説明
CONTAINSDirectoryDirectoryディレクトリにサブディレクトリが含まれます
CONTAINSDirectoryFileディレクトリにファイルが含まれます
DEFINESFileDefinitionファイルで、クラスや関数などのコード定義を定義します
DEFINESDefinitionDefinition外側の定義には、クラスとそのメソッドなど、ネストされた定義が字句的に含まれます
IMPORTSFileImportedSymbolファイルにインポートステートメントが含まれます
IMPORTSImportedSymbolDefinitionインポートされたシンボルが別のファイル内の具体的な定義に解決されます
CALLSDefinitionDefinition定義から別の定義を呼び出します
CALLSDefinitionImportedSymbol定義から、定義に解決されていないインポートされたシンボルを呼び出します
CALLSFileDefinitionまたはImportedSymbolいずれの定義にも含まれないトップレベルの呼び出しサイト
EXTENDS 1DefinitionDefinition定義で、ファイル内に宣言された関数、クラス、メソッド、モジュール、またはその他の名前付きシンボルのスーパータイプを宣言します

補足説明:

  1. EXTENDSは子から親を指します。ベースクラスを継承するクラスはソースノードであり、ベースクラスはターゲットノードです。