게이트웨이 · 커넥터
외부 데이터 커넥터 · 게이트웨이 세션 · 안전 쿼리 관련 명령
회사에 등록된 외부 데이터(DB · REST API · Google Drive)에 게이트웨이를 거쳐 안전하게 접근할 때 이 페이지를 봐요. 흐름은 늘 같아요 — connectors mine으로 내 grant가 닿는 커넥터를 확인하고, gateway session start로 세션을 열고, query · invoke · document-invoke · file-invoke로 호출해요. 모든 호출은 grant에 묶인 프리셋 · 접근 정책의 가드를 통과해요. 커넥터 연결과 안전장치의 전체 그림은 데이터 연결 가이드에서 다뤄요.
axhub connectors
게이트웨이 커넥터(외부 DB · API)를 조회하고 리소스를 탐색해요.
axhub connectors discover
커넥터 리소스 탐색(discovery)을 즉시 실행해요 (관리자).
| 플래그 | 타입 | 설명 | 기본값 |
|---|---|---|---|
<connector_id> | string (인자) | — | — |
--dry-run | boolean | Preview the operation without applying state changes. | true |
--execute | boolean | Apply the state-changing operation instead of previewing it. | — |
--tenant | string | Tenant slug or ID used to scope the command. | — |
axhub connectors app-db
axhub 앱의 전용 데이터베이스를 커넥터로 노출해요 (spec 130).
axhub connectors app-db eligible
DB를 커넥터로 노출할 수 있는 앱 목록을 봐요 (읽기 전용).
| 플래그 | 타입 | 설명 | 기본값 |
|---|---|---|---|
--tenant | string | Tenant id/slug/name override. Defaults to the active tenant membership | — |
--limit | integer | Backend page size for this request | — |
--cursor | string | Cursor from a previous page's next_cursor | — |
axhub connectors app-db create
앱 하나의 데이터베이스를 커넥터로 노출해요.
| 플래그 | 타입 | 설명 | 기본값 |
|---|---|---|---|
--app | string | App id or slug to expose | — |
--tenant | string | Tenant slug or ID used to scope the command. | — |
--dry-run | boolean | Preview the operation without applying state changes. | true |
--execute | boolean | Apply the state-changing operation instead of previewing it. | — |
axhub connectors google
Google Drive OAuth로 커넥터를 만들어요.
axhub connectors google finalize
Google Drive OAuth를 마무리하고 커넥터를 생성해요.
| 플래그 | 타입 | 설명 | 기본값 |
|---|---|---|---|
--description | string | Human-readable description for the resource. | — |
--drive-id | string | — | — |
--dry-run | boolean | Preview the operation without applying state changes. | true |
--execute | boolean | Apply the state-changing operation instead of previewing it. | — |
--name | string | Resource display name. | — |
--state | string | — | — |
--tenant | string | Tenant slug or ID used to scope the command. | — |
axhub connectors google start
Google Drive OAuth를 시작하고 인가 URL을 받아요.
| 플래그 | 타입 | 설명 | 기본값 |
|---|---|---|---|
--return-to | string | — | — |
--tenant | string | Tenant slug or ID used to scope the command. | — |
axhub connectors mine
활성 grant로 접근 가능한 커넥터 목록을 봐요.
| 플래그 | 타입 | 설명 | 기본값 |
|---|---|---|---|
--tenant | string | Tenant slug or ID used to scope the command. | — |
axhub connectors resources
접근 가능한 커넥터의 리소스 트리를 봐요.
| 플래그 | 타입 | 설명 | 기본값 |
|---|---|---|---|
<connector_id> | string (인자) | — | — |
--admin | boolean | — | — |
--limit | integer | Pagination control for list output. | — |
--offset | integer | Pagination control for list output. | — |
--q | string | Search query string. | — |
--tenant | string | Tenant slug or ID used to scope the command. | — |
axhub gateway
게이트웨이 세션 · 가드된 SQL 쿼리 · REST 호출을 실행해요 (DAC).
axhub gateway document-invoke
문서형(NoSQL) 커넥터 연산을 호출해요 (활성 세션 필요).
| 플래그 | 타입 | 설명 | 기본값 |
|---|---|---|---|
--body-json | string | Full op body as one JSON object. Optional — the body can be built from the typed flags below alone. Individual flags override matching keys. The CLI always injects session_id and op last | — |
--collection | string | Target collection name | — |
--database | string | Target database name | — |
--document | string | Single document as a JSON value | — |
--documents | string | Multiple documents as a JSON array | — |
--dry-run | boolean | Preview the operation without applying state changes. | true |
--execute | boolean | Apply the state-changing operation instead of previewing it. | — |
--field | string | Target field name | — |
--filter | string | Query filter as a JSON value | — |
--limit | integer | Result limit | — |
--op | string | Document-store op. Free-form: the backend SDK is the source of truth and validates supported ops, so new ops work without a CLI change | — |
--pipeline | string | Aggregation pipeline as a JSON array | — |
--projection | string | Projection as a JSON value | — |
--session-id | string | Active gateway session id (from axhub gateway session start) | — |
--skip | string | Result skip/offset | — |
--sort | string | Sort spec as a JSON value | — |
--tenant | string | Tenant slug or ID used to scope the command. | — |
--update | string | Update spec as a JSON value | — |
axhub gateway file-invoke
Google Drive · 파일 스토리지 액션을 게이트웨이로 호출해요.
| 플래그 | 타입 | 설명 | 기본값 |
|---|---|---|---|
--action | string | — | — |
--dry-run | boolean | Preview the operation without applying state changes. | true |
--execute | boolean | Apply the state-changing operation instead of previewing it. | — |
--file-id | string | — | — |
--parent-folder-id | string | — | — |
--q | string | Search query string. | — |
--session-id | string | — | — |
--tenant | string | Tenant slug or ID used to scope the command. | — |
axhub gateway invoke
REST 커넥터 엔드포인트를 게이트웨이로 호출해요 (활성 세션 필요).
| 플래그 | 타입 | 설명 | 기본값 |
|---|---|---|---|
--body | string | Raw request body. The CLI base64-encodes it per the gateway wire contract | — |
--body-file | string | Read the raw request body from a file | — |
--dry-run | boolean | Preview the operation without applying state changes. | true |
--execute | boolean | Apply the state-changing operation instead of previewing it. | — |
--header | string | Repeatable request header in Name: Value form | — |
--method | string | — | — |
--path | string | Connector-relative request path (e.g. /api/v1/users) | — |
--session-id | string | Active gateway session id (from axhub gateway session start) | — |
--tenant | string | Tenant slug or ID used to scope the command. | — |
axhub gateway query
가드된 파이프라인으로 SQL을 실행해요 (활성 세션 필요).
| 플래그 | 타입 | 설명 | 기본값 |
|---|---|---|---|
--action | string | Override the inferred SQL action (db preset vocabulary, e.g. SELECT or INSERT) | — |
--allow-non-select | boolean | Allow statements other than SELECT/WITH (the preset must still allow the action) | — |
--dry-run | boolean | Preview the operation without applying state changes. | true |
--execute | boolean | Apply the state-changing operation instead of previewing it. | — |
--params-json | string | JSON array of positional query parameters | — |
--session-id | string | Active gateway session id (from axhub gateway session start) | — |
--sql | string | — | — |
--sql-file | string | — | — |
--tenant | string | Tenant slug or ID used to scope the command. | — |
DB 프리셋 액션 어휘에는 읽기 전용으로 분류되는 EXPLAIN 도 있어요 (spec 168) — "SQL은 SELECT/WITH만 가능"은 더 이상 정확한 서술이 아니에요. EXPLAIN 문은 SELECT/WITH가 아니므로 프리셋이 EXPLAIN을 허용하는 상태에서 --allow-non-select와 함께 실행해요.
grant에 범위(scope_resource_paths) 가 지정돼 있으면 자유 SQL(gateway query)은 거부돼요 (spec 172) — 403 scope_requires_target, 범위 밖 리소스 접근은 403 scope_out_of_range로 실패해요.
axhub gateway session
게이트웨이 접근 세션을 관리해요 (8시간 TTL, 활성 grant 스냅샷).
axhub gateway session end
활성 세션을 종료해요.
| 플래그 | 타입 | 설명 | 기본값 |
|---|---|---|---|
<session_id> | string (인자) | — | — |
--tenant | string | Tenant slug or ID used to scope the command. | — |
axhub gateway session start
접근 가능한 커넥터로 세션을 시작해요.
| 플래그 | 타입 | 설명 | 기본값 |
|---|---|---|---|
--connector-id | string | — | — |
--mfa-verified | boolean | Mark the session as MFA-verified | — |
--tenant | string | Tenant slug or ID used to scope the command. | — |