robosystems-client 0.2.3__py3-none-any.whl → 0.2.4__py3-none-any.whl
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Potentially problematic release.
This version of robosystems-client might be problematic. Click here for more details.
- robosystems_client/api/agent/auto_select_agent.py +1 -41
- robosystems_client/api/agent/batch_process_queries.py +1 -41
- robosystems_client/api/agent/execute_specific_agent.py +1 -41
- robosystems_client/api/agent/get_agent_metadata.py +5 -49
- robosystems_client/api/agent/list_agents.py +4 -42
- robosystems_client/api/agent/recommend_agent.py +5 -45
- robosystems_client/api/auth/generate_sso_token.py +0 -18
- robosystems_client/api/auth/get_current_auth_user.py +14 -74
- robosystems_client/api/auth/logout_user.py +14 -50
- robosystems_client/api/auth/refresh_auth_session.py +14 -50
- robosystems_client/api/auth/resend_verification_email.py +14 -74
- robosystems_client/api/backup/create_backup.py +5 -45
- robosystems_client/api/backup/get_backup_download_url.py +4 -42
- robosystems_client/api/backup/get_backup_stats.py +5 -49
- robosystems_client/api/backup/list_backups.py +4 -42
- robosystems_client/api/backup/restore_backup.py +5 -45
- robosystems_client/api/connections/create_connection.py +5 -45
- robosystems_client/api/connections/create_link_token.py +5 -45
- robosystems_client/api/connections/delete_connection.py +5 -49
- robosystems_client/api/connections/exchange_link_token.py +5 -45
- robosystems_client/api/connections/get_connection.py +5 -49
- robosystems_client/api/connections/get_connection_options.py +5 -49
- robosystems_client/api/connections/init_o_auth.py +5 -45
- robosystems_client/api/connections/list_connections.py +4 -42
- robosystems_client/api/connections/oauth_callback.py +5 -45
- robosystems_client/api/connections/sync_connection.py +5 -45
- robosystems_client/api/graph_analytics/get_graph_metrics.py +5 -49
- robosystems_client/api/graph_analytics/get_graph_usage_stats.py +4 -42
- robosystems_client/api/graph_billing/get_current_graph_bill.py +5 -49
- robosystems_client/api/graph_billing/get_graph_billing_history.py +4 -42
- robosystems_client/api/graph_billing/get_graph_monthly_bill.py +5 -49
- robosystems_client/api/graph_billing/get_graph_usage_details.py +4 -42
- robosystems_client/api/graph_credits/check_credit_balance.py +0 -38
- robosystems_client/api/graph_credits/check_storage_limits.py +1 -45
- robosystems_client/api/graph_credits/get_credit_summary.py +1 -45
- robosystems_client/api/graph_credits/get_storage_usage.py +0 -38
- robosystems_client/api/graph_credits/list_credit_transactions.py +4 -42
- robosystems_client/api/graph_health/get_database_health.py +5 -49
- robosystems_client/api/graph_info/get_database_info.py +5 -49
- robosystems_client/api/graph_limits/get_graph_limits.py +5 -49
- robosystems_client/api/graphs/create_graph.py +21 -57
- robosystems_client/api/graphs/get_available_extensions.py +131 -15
- robosystems_client/api/graphs/get_graphs.py +154 -79
- robosystems_client/api/graphs/select_graph.py +117 -49
- robosystems_client/api/mcp/call_mcp_tool.py +24 -47
- robosystems_client/api/mcp/list_mcp_tools.py +13 -61
- robosystems_client/api/operations/cancel_operation.py +1 -45
- robosystems_client/api/operations/get_operation_status.py +1 -45
- robosystems_client/api/query/execute_cypher_query.py +69 -53
- robosystems_client/api/schema/export_graph_schema.py +223 -65
- robosystems_client/api/schema/get_graph_schema.py +137 -79
- robosystems_client/api/schema/validate_schema.py +5 -45
- robosystems_client/api/subgraphs/create_subgraph.py +5 -45
- robosystems_client/api/subgraphs/delete_subgraph.py +5 -45
- robosystems_client/api/subgraphs/get_subgraph_info.py +5 -49
- robosystems_client/api/subgraphs/get_subgraph_quota.py +5 -49
- robosystems_client/api/subgraphs/list_subgraphs.py +5 -49
- robosystems_client/api/tables/delete_file.py +181 -301
- robosystems_client/api/tables/get_file_info.py +117 -265
- robosystems_client/api/tables/get_upload_url.py +193 -389
- robosystems_client/api/tables/ingest_tables.py +277 -465
- robosystems_client/api/tables/list_table_files.py +193 -373
- robosystems_client/api/tables/list_tables.py +189 -361
- robosystems_client/api/tables/query_tables.py +85 -141
- robosystems_client/api/tables/update_file_status.py +205 -349
- robosystems_client/api/user/create_user_api_key.py +1 -41
- robosystems_client/api/user/get_all_credit_summaries.py +14 -111
- robosystems_client/api/user/get_current_user.py +14 -75
- robosystems_client/api/user/list_user_api_keys.py +14 -75
- robosystems_client/api/user/revoke_user_api_key.py +1 -45
- robosystems_client/api/user/update_user.py +1 -41
- robosystems_client/api/user/update_user_api_key.py +1 -41
- robosystems_client/api/user/update_user_password.py +1 -41
- robosystems_client/api/user_analytics/get_detailed_user_analytics.py +0 -38
- robosystems_client/api/user_analytics/get_user_usage_overview.py +14 -75
- robosystems_client/api/user_limits/get_all_shared_repository_limits.py +14 -105
- robosystems_client/api/user_limits/get_shared_repository_limits.py +1 -45
- robosystems_client/api/user_limits/get_user_limits.py +14 -75
- robosystems_client/api/user_limits/get_user_usage.py +14 -75
- robosystems_client/api/user_subscriptions/cancel_shared_repository_subscription.py +1 -45
- robosystems_client/api/user_subscriptions/get_repository_credits.py +1 -45
- robosystems_client/api/user_subscriptions/get_shared_repository_credits.py +14 -75
- robosystems_client/api/user_subscriptions/get_user_shared_subscriptions.py +0 -38
- robosystems_client/api/user_subscriptions/subscribe_to_shared_repository.py +1 -41
- robosystems_client/api/user_subscriptions/upgrade_shared_repository_subscription.py +1 -41
- robosystems_client/extensions/__init__.py +8 -1
- robosystems_client/extensions/auth_integration.py +1 -2
- robosystems_client/extensions/query_client.py +3 -2
- robosystems_client/extensions/sse_client.py +1 -1
- robosystems_client/extensions/table_ingest_client.py +5 -0
- robosystems_client/extensions/utils.py +2 -2
- robosystems_client/models/__init__.py +4 -4
- robosystems_client/models/create_graph_request.py +4 -3
- robosystems_client/models/cypher_query_request.py +5 -22
- robosystems_client/models/schema_export_response.py +4 -2
- robosystems_client/models/schema_info_response.py +77 -0
- robosystems_client/models/{get_graph_schema_response_getgraphschema.py → schema_info_response_schema.py} +6 -6
- robosystems_client/models/schema_validation_response.py +7 -6
- robosystems_client/models/table_query_request.py +37 -2
- {robosystems_client-0.2.3.dist-info → robosystems_client-0.2.4.dist-info}/METADATA +2 -4
- {robosystems_client-0.2.3.dist-info → robosystems_client-0.2.4.dist-info}/RECORD +103 -102
- {robosystems_client-0.2.3.dist-info → robosystems_client-0.2.4.dist-info}/WHEEL +0 -0
- {robosystems_client-0.2.3.dist-info → robosystems_client-0.2.4.dist-info}/licenses/LICENSE +0 -0
|
@@ -8,38 +8,18 @@ from ...client import AuthenticatedClient, Client
|
|
|
8
8
|
from ...models.error_response import ErrorResponse
|
|
9
9
|
from ...models.http_validation_error import HTTPValidationError
|
|
10
10
|
from ...models.list_table_files_response import ListTableFilesResponse
|
|
11
|
-
from ...types import
|
|
11
|
+
from ...types import Response
|
|
12
12
|
|
|
13
13
|
|
|
14
14
|
def _get_kwargs(
|
|
15
15
|
graph_id: str,
|
|
16
16
|
table_name: str,
|
|
17
|
-
*,
|
|
18
|
-
token: Union[None, Unset, str] = UNSET,
|
|
19
|
-
authorization: Union[None, Unset, str] = UNSET,
|
|
20
17
|
) -> dict[str, Any]:
|
|
21
|
-
headers: dict[str, Any] = {}
|
|
22
|
-
if not isinstance(authorization, Unset):
|
|
23
|
-
headers["authorization"] = authorization
|
|
24
|
-
|
|
25
|
-
params: dict[str, Any] = {}
|
|
26
|
-
|
|
27
|
-
json_token: Union[None, Unset, str]
|
|
28
|
-
if isinstance(token, Unset):
|
|
29
|
-
json_token = UNSET
|
|
30
|
-
else:
|
|
31
|
-
json_token = token
|
|
32
|
-
params["token"] = json_token
|
|
33
|
-
|
|
34
|
-
params = {k: v for k, v in params.items() if v is not UNSET and v is not None}
|
|
35
|
-
|
|
36
18
|
_kwargs: dict[str, Any] = {
|
|
37
19
|
"method": "get",
|
|
38
20
|
"url": f"/v1/graphs/{graph_id}/tables/{table_name}/files",
|
|
39
|
-
"params": params,
|
|
40
21
|
}
|
|
41
22
|
|
|
42
|
-
_kwargs["headers"] = headers
|
|
43
23
|
return _kwargs
|
|
44
24
|
|
|
45
25
|
|
|
@@ -96,99 +76,59 @@ def sync_detailed(
|
|
|
96
76
|
table_name: str,
|
|
97
77
|
*,
|
|
98
78
|
client: AuthenticatedClient,
|
|
99
|
-
token: Union[None, Unset, str] = UNSET,
|
|
100
|
-
authorization: Union[None, Unset, str] = UNSET,
|
|
101
79
|
) -> Response[Union[Any, ErrorResponse, HTTPValidationError, ListTableFilesResponse]]:
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
\"s3_key\": \"user-staging/user123/kg123/Entity/entities_batch1.parquet\"
|
|
151
|
-
}
|
|
152
|
-
],
|
|
153
|
-
\"total_files\": 1,
|
|
154
|
-
\"total_size_bytes\": 1048576
|
|
155
|
-
}
|
|
156
|
-
```
|
|
157
|
-
|
|
158
|
-
**Example Usage:**
|
|
159
|
-
```bash
|
|
160
|
-
curl -H \"Authorization: Bearer YOUR_TOKEN\" \
|
|
161
|
-
https://api.robosystems.ai/v1/graphs/kg123/tables/Entity/files
|
|
162
|
-
```
|
|
163
|
-
|
|
164
|
-
**Tips:**
|
|
165
|
-
- Only `uploaded` files are ingested
|
|
166
|
-
- Check `row_count` to estimate data volume
|
|
167
|
-
- Use `total_size_bytes` for storage monitoring
|
|
168
|
-
- Files with `failed` status should be deleted and re-uploaded
|
|
169
|
-
|
|
170
|
-
**Note:**
|
|
171
|
-
File listing is included - no credit consumption.
|
|
172
|
-
|
|
173
|
-
Args:
|
|
174
|
-
graph_id (str): Graph database identifier
|
|
175
|
-
table_name (str): Table name
|
|
176
|
-
token (Union[None, Unset, str]): JWT token for SSE authentication
|
|
177
|
-
authorization (Union[None, Unset, str]):
|
|
178
|
-
|
|
179
|
-
Raises:
|
|
180
|
-
errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
|
|
181
|
-
httpx.TimeoutException: If the request takes longer than Client.timeout.
|
|
182
|
-
|
|
183
|
-
Returns:
|
|
184
|
-
Response[Union[Any, ErrorResponse, HTTPValidationError, ListTableFilesResponse]]
|
|
185
|
-
"""
|
|
80
|
+
"""List Files in Staging Table
|
|
81
|
+
|
|
82
|
+
List all files uploaded to a staging table with comprehensive metadata.
|
|
83
|
+
|
|
84
|
+
Get a complete inventory of all files in a staging table, including upload status,
|
|
85
|
+
file sizes, row counts, and S3 locations. Essential for monitoring upload progress
|
|
86
|
+
and validating data before ingestion.
|
|
87
|
+
|
|
88
|
+
**Use Cases:**
|
|
89
|
+
- Monitor file upload progress
|
|
90
|
+
- Verify files are ready for ingestion
|
|
91
|
+
- Check file formats and sizes
|
|
92
|
+
- Track storage usage per table
|
|
93
|
+
- Identify failed or incomplete uploads
|
|
94
|
+
- Pre-ingestion validation
|
|
95
|
+
|
|
96
|
+
**Returned Metadata:**
|
|
97
|
+
- File ID, name, and format (parquet, csv, json)
|
|
98
|
+
- Size in bytes and row count (if available)
|
|
99
|
+
- Upload status and method
|
|
100
|
+
- Creation and upload timestamps
|
|
101
|
+
- S3 key for reference
|
|
102
|
+
|
|
103
|
+
**Upload Status Values:**
|
|
104
|
+
- `pending`: Upload URL generated, awaiting upload
|
|
105
|
+
- `uploaded`: Successfully uploaded, ready for ingestion
|
|
106
|
+
- `disabled`: Excluded from ingestion
|
|
107
|
+
- `archived`: Soft deleted
|
|
108
|
+
- `failed`: Upload failed
|
|
109
|
+
|
|
110
|
+
**Important Notes:**
|
|
111
|
+
- Only `uploaded` files are ingested
|
|
112
|
+
- Check `row_count` to estimate data volume
|
|
113
|
+
- Use `total_size_bytes` for storage monitoring
|
|
114
|
+
- Files with `failed` status should be deleted and re-uploaded
|
|
115
|
+
- File listing is included - no credit consumption
|
|
116
|
+
|
|
117
|
+
Args:
|
|
118
|
+
graph_id (str):
|
|
119
|
+
table_name (str): Table name
|
|
120
|
+
|
|
121
|
+
Raises:
|
|
122
|
+
errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
|
|
123
|
+
httpx.TimeoutException: If the request takes longer than Client.timeout.
|
|
124
|
+
|
|
125
|
+
Returns:
|
|
126
|
+
Response[Union[Any, ErrorResponse, HTTPValidationError, ListTableFilesResponse]]
|
|
127
|
+
"""
|
|
186
128
|
|
|
187
129
|
kwargs = _get_kwargs(
|
|
188
130
|
graph_id=graph_id,
|
|
189
131
|
table_name=table_name,
|
|
190
|
-
token=token,
|
|
191
|
-
authorization=authorization,
|
|
192
132
|
)
|
|
193
133
|
|
|
194
134
|
response = client.get_httpx_client().request(
|
|
@@ -203,100 +143,60 @@ def sync(
|
|
|
203
143
|
table_name: str,
|
|
204
144
|
*,
|
|
205
145
|
client: AuthenticatedClient,
|
|
206
|
-
token: Union[None, Unset, str] = UNSET,
|
|
207
|
-
authorization: Union[None, Unset, str] = UNSET,
|
|
208
146
|
) -> Optional[Union[Any, ErrorResponse, HTTPValidationError, ListTableFilesResponse]]:
|
|
209
|
-
|
|
210
|
-
|
|
211
|
-
|
|
212
|
-
|
|
213
|
-
|
|
214
|
-
|
|
215
|
-
|
|
216
|
-
|
|
217
|
-
|
|
218
|
-
|
|
219
|
-
|
|
220
|
-
|
|
221
|
-
|
|
222
|
-
|
|
223
|
-
|
|
224
|
-
|
|
225
|
-
|
|
226
|
-
|
|
227
|
-
|
|
228
|
-
|
|
229
|
-
|
|
230
|
-
|
|
231
|
-
|
|
232
|
-
|
|
233
|
-
|
|
234
|
-
|
|
235
|
-
|
|
236
|
-
|
|
237
|
-
|
|
238
|
-
|
|
239
|
-
|
|
240
|
-
|
|
241
|
-
|
|
242
|
-
|
|
243
|
-
|
|
244
|
-
|
|
245
|
-
|
|
246
|
-
|
|
247
|
-
|
|
248
|
-
|
|
249
|
-
|
|
250
|
-
|
|
251
|
-
|
|
252
|
-
|
|
253
|
-
|
|
254
|
-
|
|
255
|
-
|
|
256
|
-
|
|
257
|
-
\"s3_key\": \"user-staging/user123/kg123/Entity/entities_batch1.parquet\"
|
|
258
|
-
}
|
|
259
|
-
],
|
|
260
|
-
\"total_files\": 1,
|
|
261
|
-
\"total_size_bytes\": 1048576
|
|
262
|
-
}
|
|
263
|
-
```
|
|
264
|
-
|
|
265
|
-
**Example Usage:**
|
|
266
|
-
```bash
|
|
267
|
-
curl -H \"Authorization: Bearer YOUR_TOKEN\" \
|
|
268
|
-
https://api.robosystems.ai/v1/graphs/kg123/tables/Entity/files
|
|
269
|
-
```
|
|
270
|
-
|
|
271
|
-
**Tips:**
|
|
272
|
-
- Only `uploaded` files are ingested
|
|
273
|
-
- Check `row_count` to estimate data volume
|
|
274
|
-
- Use `total_size_bytes` for storage monitoring
|
|
275
|
-
- Files with `failed` status should be deleted and re-uploaded
|
|
276
|
-
|
|
277
|
-
**Note:**
|
|
278
|
-
File listing is included - no credit consumption.
|
|
279
|
-
|
|
280
|
-
Args:
|
|
281
|
-
graph_id (str): Graph database identifier
|
|
282
|
-
table_name (str): Table name
|
|
283
|
-
token (Union[None, Unset, str]): JWT token for SSE authentication
|
|
284
|
-
authorization (Union[None, Unset, str]):
|
|
285
|
-
|
|
286
|
-
Raises:
|
|
287
|
-
errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
|
|
288
|
-
httpx.TimeoutException: If the request takes longer than Client.timeout.
|
|
289
|
-
|
|
290
|
-
Returns:
|
|
291
|
-
Union[Any, ErrorResponse, HTTPValidationError, ListTableFilesResponse]
|
|
292
|
-
"""
|
|
147
|
+
"""List Files in Staging Table
|
|
148
|
+
|
|
149
|
+
List all files uploaded to a staging table with comprehensive metadata.
|
|
150
|
+
|
|
151
|
+
Get a complete inventory of all files in a staging table, including upload status,
|
|
152
|
+
file sizes, row counts, and S3 locations. Essential for monitoring upload progress
|
|
153
|
+
and validating data before ingestion.
|
|
154
|
+
|
|
155
|
+
**Use Cases:**
|
|
156
|
+
- Monitor file upload progress
|
|
157
|
+
- Verify files are ready for ingestion
|
|
158
|
+
- Check file formats and sizes
|
|
159
|
+
- Track storage usage per table
|
|
160
|
+
- Identify failed or incomplete uploads
|
|
161
|
+
- Pre-ingestion validation
|
|
162
|
+
|
|
163
|
+
**Returned Metadata:**
|
|
164
|
+
- File ID, name, and format (parquet, csv, json)
|
|
165
|
+
- Size in bytes and row count (if available)
|
|
166
|
+
- Upload status and method
|
|
167
|
+
- Creation and upload timestamps
|
|
168
|
+
- S3 key for reference
|
|
169
|
+
|
|
170
|
+
**Upload Status Values:**
|
|
171
|
+
- `pending`: Upload URL generated, awaiting upload
|
|
172
|
+
- `uploaded`: Successfully uploaded, ready for ingestion
|
|
173
|
+
- `disabled`: Excluded from ingestion
|
|
174
|
+
- `archived`: Soft deleted
|
|
175
|
+
- `failed`: Upload failed
|
|
176
|
+
|
|
177
|
+
**Important Notes:**
|
|
178
|
+
- Only `uploaded` files are ingested
|
|
179
|
+
- Check `row_count` to estimate data volume
|
|
180
|
+
- Use `total_size_bytes` for storage monitoring
|
|
181
|
+
- Files with `failed` status should be deleted and re-uploaded
|
|
182
|
+
- File listing is included - no credit consumption
|
|
183
|
+
|
|
184
|
+
Args:
|
|
185
|
+
graph_id (str):
|
|
186
|
+
table_name (str): Table name
|
|
187
|
+
|
|
188
|
+
Raises:
|
|
189
|
+
errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
|
|
190
|
+
httpx.TimeoutException: If the request takes longer than Client.timeout.
|
|
191
|
+
|
|
192
|
+
Returns:
|
|
193
|
+
Union[Any, ErrorResponse, HTTPValidationError, ListTableFilesResponse]
|
|
194
|
+
"""
|
|
293
195
|
|
|
294
196
|
return sync_detailed(
|
|
295
197
|
graph_id=graph_id,
|
|
296
198
|
table_name=table_name,
|
|
297
199
|
client=client,
|
|
298
|
-
token=token,
|
|
299
|
-
authorization=authorization,
|
|
300
200
|
).parsed
|
|
301
201
|
|
|
302
202
|
|
|
@@ -305,99 +205,59 @@ async def asyncio_detailed(
|
|
|
305
205
|
table_name: str,
|
|
306
206
|
*,
|
|
307
207
|
client: AuthenticatedClient,
|
|
308
|
-
token: Union[None, Unset, str] = UNSET,
|
|
309
|
-
authorization: Union[None, Unset, str] = UNSET,
|
|
310
208
|
) -> Response[Union[Any, ErrorResponse, HTTPValidationError, ListTableFilesResponse]]:
|
|
311
|
-
|
|
312
|
-
|
|
313
|
-
|
|
314
|
-
|
|
315
|
-
|
|
316
|
-
|
|
317
|
-
|
|
318
|
-
|
|
319
|
-
|
|
320
|
-
|
|
321
|
-
|
|
322
|
-
|
|
323
|
-
|
|
324
|
-
|
|
325
|
-
|
|
326
|
-
|
|
327
|
-
|
|
328
|
-
|
|
329
|
-
|
|
330
|
-
|
|
331
|
-
|
|
332
|
-
|
|
333
|
-
|
|
334
|
-
|
|
335
|
-
|
|
336
|
-
|
|
337
|
-
|
|
338
|
-
|
|
339
|
-
|
|
340
|
-
|
|
341
|
-
|
|
342
|
-
|
|
343
|
-
|
|
344
|
-
|
|
345
|
-
|
|
346
|
-
|
|
347
|
-
|
|
348
|
-
|
|
349
|
-
|
|
350
|
-
|
|
351
|
-
|
|
352
|
-
|
|
353
|
-
|
|
354
|
-
|
|
355
|
-
|
|
356
|
-
|
|
357
|
-
|
|
358
|
-
|
|
359
|
-
\"s3_key\": \"user-staging/user123/kg123/Entity/entities_batch1.parquet\"
|
|
360
|
-
}
|
|
361
|
-
],
|
|
362
|
-
\"total_files\": 1,
|
|
363
|
-
\"total_size_bytes\": 1048576
|
|
364
|
-
}
|
|
365
|
-
```
|
|
366
|
-
|
|
367
|
-
**Example Usage:**
|
|
368
|
-
```bash
|
|
369
|
-
curl -H \"Authorization: Bearer YOUR_TOKEN\" \
|
|
370
|
-
https://api.robosystems.ai/v1/graphs/kg123/tables/Entity/files
|
|
371
|
-
```
|
|
372
|
-
|
|
373
|
-
**Tips:**
|
|
374
|
-
- Only `uploaded` files are ingested
|
|
375
|
-
- Check `row_count` to estimate data volume
|
|
376
|
-
- Use `total_size_bytes` for storage monitoring
|
|
377
|
-
- Files with `failed` status should be deleted and re-uploaded
|
|
378
|
-
|
|
379
|
-
**Note:**
|
|
380
|
-
File listing is included - no credit consumption.
|
|
381
|
-
|
|
382
|
-
Args:
|
|
383
|
-
graph_id (str): Graph database identifier
|
|
384
|
-
table_name (str): Table name
|
|
385
|
-
token (Union[None, Unset, str]): JWT token for SSE authentication
|
|
386
|
-
authorization (Union[None, Unset, str]):
|
|
387
|
-
|
|
388
|
-
Raises:
|
|
389
|
-
errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
|
|
390
|
-
httpx.TimeoutException: If the request takes longer than Client.timeout.
|
|
391
|
-
|
|
392
|
-
Returns:
|
|
393
|
-
Response[Union[Any, ErrorResponse, HTTPValidationError, ListTableFilesResponse]]
|
|
394
|
-
"""
|
|
209
|
+
"""List Files in Staging Table
|
|
210
|
+
|
|
211
|
+
List all files uploaded to a staging table with comprehensive metadata.
|
|
212
|
+
|
|
213
|
+
Get a complete inventory of all files in a staging table, including upload status,
|
|
214
|
+
file sizes, row counts, and S3 locations. Essential for monitoring upload progress
|
|
215
|
+
and validating data before ingestion.
|
|
216
|
+
|
|
217
|
+
**Use Cases:**
|
|
218
|
+
- Monitor file upload progress
|
|
219
|
+
- Verify files are ready for ingestion
|
|
220
|
+
- Check file formats and sizes
|
|
221
|
+
- Track storage usage per table
|
|
222
|
+
- Identify failed or incomplete uploads
|
|
223
|
+
- Pre-ingestion validation
|
|
224
|
+
|
|
225
|
+
**Returned Metadata:**
|
|
226
|
+
- File ID, name, and format (parquet, csv, json)
|
|
227
|
+
- Size in bytes and row count (if available)
|
|
228
|
+
- Upload status and method
|
|
229
|
+
- Creation and upload timestamps
|
|
230
|
+
- S3 key for reference
|
|
231
|
+
|
|
232
|
+
**Upload Status Values:**
|
|
233
|
+
- `pending`: Upload URL generated, awaiting upload
|
|
234
|
+
- `uploaded`: Successfully uploaded, ready for ingestion
|
|
235
|
+
- `disabled`: Excluded from ingestion
|
|
236
|
+
- `archived`: Soft deleted
|
|
237
|
+
- `failed`: Upload failed
|
|
238
|
+
|
|
239
|
+
**Important Notes:**
|
|
240
|
+
- Only `uploaded` files are ingested
|
|
241
|
+
- Check `row_count` to estimate data volume
|
|
242
|
+
- Use `total_size_bytes` for storage monitoring
|
|
243
|
+
- Files with `failed` status should be deleted and re-uploaded
|
|
244
|
+
- File listing is included - no credit consumption
|
|
245
|
+
|
|
246
|
+
Args:
|
|
247
|
+
graph_id (str):
|
|
248
|
+
table_name (str): Table name
|
|
249
|
+
|
|
250
|
+
Raises:
|
|
251
|
+
errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
|
|
252
|
+
httpx.TimeoutException: If the request takes longer than Client.timeout.
|
|
253
|
+
|
|
254
|
+
Returns:
|
|
255
|
+
Response[Union[Any, ErrorResponse, HTTPValidationError, ListTableFilesResponse]]
|
|
256
|
+
"""
|
|
395
257
|
|
|
396
258
|
kwargs = _get_kwargs(
|
|
397
259
|
graph_id=graph_id,
|
|
398
260
|
table_name=table_name,
|
|
399
|
-
token=token,
|
|
400
|
-
authorization=authorization,
|
|
401
261
|
)
|
|
402
262
|
|
|
403
263
|
response = await client.get_async_httpx_client().request(**kwargs)
|
|
@@ -410,100 +270,60 @@ async def asyncio(
|
|
|
410
270
|
table_name: str,
|
|
411
271
|
*,
|
|
412
272
|
client: AuthenticatedClient,
|
|
413
|
-
token: Union[None, Unset, str] = UNSET,
|
|
414
|
-
authorization: Union[None, Unset, str] = UNSET,
|
|
415
273
|
) -> Optional[Union[Any, ErrorResponse, HTTPValidationError, ListTableFilesResponse]]:
|
|
416
|
-
|
|
417
|
-
|
|
418
|
-
|
|
419
|
-
|
|
420
|
-
|
|
421
|
-
|
|
422
|
-
|
|
423
|
-
|
|
424
|
-
|
|
425
|
-
|
|
426
|
-
|
|
427
|
-
|
|
428
|
-
|
|
429
|
-
|
|
430
|
-
|
|
431
|
-
|
|
432
|
-
|
|
433
|
-
|
|
434
|
-
|
|
435
|
-
|
|
436
|
-
|
|
437
|
-
|
|
438
|
-
|
|
439
|
-
|
|
440
|
-
|
|
441
|
-
|
|
442
|
-
|
|
443
|
-
|
|
444
|
-
|
|
445
|
-
|
|
446
|
-
|
|
447
|
-
|
|
448
|
-
|
|
449
|
-
|
|
450
|
-
|
|
451
|
-
|
|
452
|
-
|
|
453
|
-
|
|
454
|
-
|
|
455
|
-
|
|
456
|
-
|
|
457
|
-
|
|
458
|
-
|
|
459
|
-
|
|
460
|
-
|
|
461
|
-
|
|
462
|
-
|
|
463
|
-
|
|
464
|
-
\"s3_key\": \"user-staging/user123/kg123/Entity/entities_batch1.parquet\"
|
|
465
|
-
}
|
|
466
|
-
],
|
|
467
|
-
\"total_files\": 1,
|
|
468
|
-
\"total_size_bytes\": 1048576
|
|
469
|
-
}
|
|
470
|
-
```
|
|
471
|
-
|
|
472
|
-
**Example Usage:**
|
|
473
|
-
```bash
|
|
474
|
-
curl -H \"Authorization: Bearer YOUR_TOKEN\" \
|
|
475
|
-
https://api.robosystems.ai/v1/graphs/kg123/tables/Entity/files
|
|
476
|
-
```
|
|
477
|
-
|
|
478
|
-
**Tips:**
|
|
479
|
-
- Only `uploaded` files are ingested
|
|
480
|
-
- Check `row_count` to estimate data volume
|
|
481
|
-
- Use `total_size_bytes` for storage monitoring
|
|
482
|
-
- Files with `failed` status should be deleted and re-uploaded
|
|
483
|
-
|
|
484
|
-
**Note:**
|
|
485
|
-
File listing is included - no credit consumption.
|
|
486
|
-
|
|
487
|
-
Args:
|
|
488
|
-
graph_id (str): Graph database identifier
|
|
489
|
-
table_name (str): Table name
|
|
490
|
-
token (Union[None, Unset, str]): JWT token for SSE authentication
|
|
491
|
-
authorization (Union[None, Unset, str]):
|
|
492
|
-
|
|
493
|
-
Raises:
|
|
494
|
-
errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
|
|
495
|
-
httpx.TimeoutException: If the request takes longer than Client.timeout.
|
|
496
|
-
|
|
497
|
-
Returns:
|
|
498
|
-
Union[Any, ErrorResponse, HTTPValidationError, ListTableFilesResponse]
|
|
499
|
-
"""
|
|
274
|
+
"""List Files in Staging Table
|
|
275
|
+
|
|
276
|
+
List all files uploaded to a staging table with comprehensive metadata.
|
|
277
|
+
|
|
278
|
+
Get a complete inventory of all files in a staging table, including upload status,
|
|
279
|
+
file sizes, row counts, and S3 locations. Essential for monitoring upload progress
|
|
280
|
+
and validating data before ingestion.
|
|
281
|
+
|
|
282
|
+
**Use Cases:**
|
|
283
|
+
- Monitor file upload progress
|
|
284
|
+
- Verify files are ready for ingestion
|
|
285
|
+
- Check file formats and sizes
|
|
286
|
+
- Track storage usage per table
|
|
287
|
+
- Identify failed or incomplete uploads
|
|
288
|
+
- Pre-ingestion validation
|
|
289
|
+
|
|
290
|
+
**Returned Metadata:**
|
|
291
|
+
- File ID, name, and format (parquet, csv, json)
|
|
292
|
+
- Size in bytes and row count (if available)
|
|
293
|
+
- Upload status and method
|
|
294
|
+
- Creation and upload timestamps
|
|
295
|
+
- S3 key for reference
|
|
296
|
+
|
|
297
|
+
**Upload Status Values:**
|
|
298
|
+
- `pending`: Upload URL generated, awaiting upload
|
|
299
|
+
- `uploaded`: Successfully uploaded, ready for ingestion
|
|
300
|
+
- `disabled`: Excluded from ingestion
|
|
301
|
+
- `archived`: Soft deleted
|
|
302
|
+
- `failed`: Upload failed
|
|
303
|
+
|
|
304
|
+
**Important Notes:**
|
|
305
|
+
- Only `uploaded` files are ingested
|
|
306
|
+
- Check `row_count` to estimate data volume
|
|
307
|
+
- Use `total_size_bytes` for storage monitoring
|
|
308
|
+
- Files with `failed` status should be deleted and re-uploaded
|
|
309
|
+
- File listing is included - no credit consumption
|
|
310
|
+
|
|
311
|
+
Args:
|
|
312
|
+
graph_id (str):
|
|
313
|
+
table_name (str): Table name
|
|
314
|
+
|
|
315
|
+
Raises:
|
|
316
|
+
errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
|
|
317
|
+
httpx.TimeoutException: If the request takes longer than Client.timeout.
|
|
318
|
+
|
|
319
|
+
Returns:
|
|
320
|
+
Union[Any, ErrorResponse, HTTPValidationError, ListTableFilesResponse]
|
|
321
|
+
"""
|
|
500
322
|
|
|
501
323
|
return (
|
|
502
324
|
await asyncio_detailed(
|
|
503
325
|
graph_id=graph_id,
|
|
504
326
|
table_name=table_name,
|
|
505
327
|
client=client,
|
|
506
|
-
token=token,
|
|
507
|
-
authorization=authorization,
|
|
508
328
|
)
|
|
509
329
|
).parsed
|