Spark Livy 로그를 검색합니다.
권한
호출자에게 항목에 대한 "읽기" 권한이 있어야 합니다.
필요한 위임된 범위
Item.Read.All 또는 Item.ReadWrite.All 또는 다음 세 그룹 중 하나(Spark 애플리케이션을 트리거한 항목에 따라).
- Notebook.Read.All 또는 Notebook.ReadWrite.All
- SparkJobDefinition.Read.All, 또는 SparkJobDefinition.ReadWrite.All
- Lakehouse.Read.All 또는 Lakehouse.ReadWrite.All (데이터 관리 권한을 나타내는 기술 용어)
Microsoft Entra 지원 아이덴티티
이 API는 이 섹션에 나열된 Microsoft ID 지원합니다.
| 아이덴티티 | 지원 |
|---|---|
| 사용자 | 예 |
| 서비스 주체 및 관리 ID | 예 |
Livy 로그 메타데이터 가져오기
Livy 로그의 메타데이터를 가져옵니다.
인터페이스
attemptId가 없는 경우
https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/notebooks|sparkJobDefinitions|lakehouses/{itemId}/livySessions/{livyId}/applications/none/logs?type=livy&meta=true
URI 매개 변수
없음
응답
| 이름 | 유형 | 설명 |
|---|---|---|
| 200 OK | FileMeta | 요청이 완료되었습니다. |
예시
샘플 요청
GET https://api.fabric.microsoft.com/v1/workspaces/aaaabbbb-0000-cccc-1111-dddd2222eeee/notebooks/bbbbcccc-1111-dddd-2222-eeee3333ffff/livySessions/ccccdddd-2222-eeee-3333-ffff4444aaaa/application/none/logs?type=livy&meta=true
상태 코드: 200
{
"fileName": "livy.log",
"length": 34723,
"lastModified": "2025-03-05T12:11:17.000GMT",
"creationTime": "2025-03-05T12:10:42.000GMT",
"metaData": {}
}
Livy 로그 콘텐츠 가져오기
Livy 로그의 파일 콘텐츠를 가져옵니다.
인터페이스
attemptId가 없는 경우
https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/notebooks|sparkJobDefinitions|lakehouses/{itemId}/livySessions/{livyId}/applications/none/logs?type=livy
선택적 매개 변수 사용:
attemptId가 없는 경우
https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/notebooks|sparkJobDefinitions|lakehouses/{itemId}/livySessions/{livyId}/applications/none/logs?type=livy&isDownload={isDownload}&isPartial={isPartial}&offset={offset}&size={size}
URI 매개 변수
| 이름 | 안으로 | 필수 | 유형 | 설명 |
|---|---|---|---|---|
| 작업공간ID (workspaceId) | 길 | 진실 | 문자열 uuid | 작업 영역 ID입니다. |
| 아이템 ID | 길 | 진실 | 문자열 uuid | Notebook 또는 Spark 작업 정의, 혹은 Lakehouse의 항목 ID입니다. |
| livyId | 길 | 진실 | 문자열 uuid | Livy 세션 ID입니다. |
| 앱 ID | 길 | 진실 | 문자열 | application_1704417105000_0001 같은 Spark 애플리케이션 ID입니다. |
| 다운로드 여부 | 문의 | 거짓 | bool | True이면 로그 파일을 스트림으로 다운로드합니다. 기본값은 false입니다. |
| isPartial (부분적 여부) | 문의 | 거짓 | bool | isDownload가 true인 경우에만 적용됩니다. True이면 지정된 오프셋 및 크기에 따라 파일 콘텐츠의 일부를 다운로드합니다. 전체 파일을 다운로드하려면 기본값을 false로 설정합니다. |
| 오프셋, 크기 | 문의 | 거짓 | 길다 | 파일 콘텐츠를 읽을 시작 오프셋(바이트) 및 크기(바이트)입니다. isDownload = true 및 isPartial = true인 경우에만 적용됩니다. - 오프셋의 경우 기본값은 0입니다. 즉, 파일의 시작 부분에서 읽는 것을 의미합니다. - 크기의 경우 기본값은 1M(1024*1024) 바이트입니다. |
응답
| 이름 | 유형 | 설명 |
|---|---|---|
| 200 OK | FileMeta | 요청이 완료되었습니다. |
예시
샘플 요청
GET https://api.fabric.microsoft.com/v1/workspaces/aaaabbbb-0000-cccc-1111-dddd2222eeee/notebooks/bbbbcccc-1111-dddd-2222-eeee3333ffff/livySessions/ccccdddd-2222-eeee-3333-ffff4444aaaa/application/none/logs?type=livy
정의
FileMeta
객체
로그 파일의 메타데이터
| 이름 | 유형 | 설명 |
|---|---|---|
| 파일이름 | 문자열 | 파일 이름 |
| 길이 | 길다 | 파일 크기(바이트)입니다. |
| 최종 수정 | 문자열 | 파일이 마지막으로 수정된 시간입니다. |
| 생성시간 | 문자열 | 파일을 만든 시간입니다. |
| 메타데이터 | 문자열에서 문자열로의 맵 | 보조 데이터가 있는 경우 |