Items - Refresh Sql Endpoint Metadata

서비스:
SQLEndpoint
API 버전:
v1

SQL 분석 엔드포인트 내에서 테이블을 새로 고칩니다.
이 API는 LRO(장기 실행 작업)지원합니다.

tables 요청 본문에 제공되면 지정된 테이블만 새로 고쳐집니다. 생략하거나 비우면 모든 테이블이 새로 고쳐집니다.

Permissions

호출자에게는 기여자 이상의 작업 영역 역할이 있어야 합니다.

필요한 위임된 범위

Item.ReadWrite.All

Microsoft Entra 지원 식별자

이 API는 이 섹션에 나열된 Microsoft ID 지원합니다.

Identity Support
User Yes
서비스 주체 및 관리 ID Yes

Interface

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/sqlEndpoints/{sqlEndpointId}/refreshMetadata

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
sqlEndpointId
 path True

string (uuid)

SQL 분석 엔드포인트 ID입니다.
workspaceId
 path True

string (uuid)

작업 영역 ID입니다.

요청 본문

Name 형식 Description
recreateTables

boolean

true로 설정하면 이 속성은 새로 고침 프로세스 중에 SQL 분석 엔드포인트의 모든 테이블을 삭제하고 다시 만들도록 시스템에 지시합니다. 예를 들어 불일치를 해결하거나 새로 고침을 새로 고치려면 원본 정의에서 테이블을 완전히 다시 작성해야 하는 경우 이 옵션을 사용합니다. 동기화 상태 재설정과 결합 tables하면 지정된 테이블로만 동기화 상태 재설정 범위가 지정됩니다. 기본값은 false입니다.
tables

TableDefinition[]

제공되면 새로 고침 범위를 나열된 테이블로만 지정합니다. 생략하거나 비우면 모든 테이블이 새로 고쳐집니다. 각 항목은 해당 스키마 아래에 새로 고칠 스키마와 하나 이상의 테이블 이름을 지정합니다. 단일 요청에서 동기화할 수 있는 최대 테이블 수는 25개입니다. 테이블 확인은 SQL 엔드포인트의 부모 항목이 스키마를 사용할 수 있는지 여부에 따라 달라집니다. 스키마 사용 항목의 경우 테이블은 호출자가 제공한 스키마를 사용하여 확인됩니다. 스키마를 사용하지 않는 항목의 경우 호출자가 제공한 스키마 값에 관계없이 모든 테이블이 기본 스키마에서 확인됩니다. 기본 스키마가 아닌 테이블은 확인할 수 없으며 오류와 함께 DeltaTableNotFound 보고됩니다.
timeout

Duration

시간이 초과되기 전의 요청 기간입니다. 기본값은 15분입니다.

응답

Name 형식 Description
200 OK

TableSyncStatuses

요청이 성공적으로 완료되었습니다.
202 Accepted

요청이 수락되었습니다. SQL 분석 테이블 새로 고침이 진행 중입니다.

헤더

  • Location: string
  • x-ms-operation-id: string
  • Retry-After: integer
429 Too Many Requests

ErrorResponse

서비스 속도 제한을 초과했습니다. 서버는 클라이언트가 Retry-After 추가 요청을 보내기 전에 대기해야 하는 시간을 초 단위로 나타내는 헤더를 반환합니다.

헤더

Retry-After: integer
Other Status Codes

ErrorResponse

일반적인 오류 코드:

  • ItemNotFound - 요청된 항목을 찾을 수 없습니다.

예제

Refresh all tables for a specified SQL analytics endpoint in a workspace
Refresh selective tables for a specified SQL analytics endpoint in a workspace
Refresh selective tables with recreate tables for a specified SQL analytics endpoint in a workspace
Refresh selective tables with user defined schemas for a specified SQL analytics endpoint in a workspace

Refresh all tables for a specified SQL analytics endpoint in a workspace

샘플 요청

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/sqlEndpoints/5b218778-e7a5-4d73-8187-f10824047715/refreshMetadata

샘플 응답

상태 코드:
200 
{
  "value": [
    {
      "tableName": "Table 1",
      "startDateTime": "2025-08-08T10:31:22.2708973Z",
      "endDateTime": "2025-08-08T10:36:54.9651741Z",
      "status": "Success",
      "lastSuccessfulSyncDateTime": "2025-08-08T10:36:54.9651741Z"
    },
    {
      "tableName": "Table 2",
      "startDateTime": "2025-08-08T10:31:22.2708973Z",
      "endDateTime": "2025-08-08T10:43:02.5329616Z",
      "status": "Failure",
      "error": {
        "errorCode": "AdalRetryException",
        "message": "Couldn't run query. There is a problem with the Microsoft Entra ID token. Have the warehouse owner log in again. If they're unavailable, use the takeover feature."
      },
      "lastSuccessfulSyncDateTime": "2025-08-07T10:44:27.2632648Z"
    },
    {
      "tableName": "Table 3",
      "startDateTime": "2025-08-08T10:31:22.2708973Z",
      "endDateTime": "2025-08-08T10:36:59.9183509Z",
      "status": "NotRun",
      "lastSuccessfulSyncDateTime": "2025-08-06T08:32:53.3890146Z"
    }
  ]
}

Refresh selective tables for a specified SQL analytics endpoint in a workspace

샘플 요청

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/sqlEndpoints/5b218778-e7a5-4d73-8187-f10824047715/refreshMetadata

{
  "tables": [
    {
      "schema": "dbo",
      "tableNames": [
        "Orders",
        "OrderDetails"
      ]
    },
    {
      "schema": "dbo",
      "tableNames": [
        "DailySummary"
      ]
    }
  ]
}

샘플 응답

상태 코드:
200 
{
  "value": [
    {
      "tableName": "Orders",
      "startDateTime": "2026-06-09T14:31:22.2708973Z",
      "endDateTime": "2026-06-09T14:31:25.9651741Z",
      "status": "Success",
      "lastSuccessfulSyncDateTime": "2026-06-09T14:31:25.9651741Z"
    },
    {
      "tableName": "OrderDetails",
      "startDateTime": "2026-06-09T14:31:22.2708973Z",
      "endDateTime": "2026-06-09T14:31:26.5329616Z",
      "status": "Failure",
      "error": {
        "errorCode": "DeltaTableNotFound",
        "message": "Delta table 'Tables\\OrderDetails\\_delta_log' not found."
      },
      "lastSuccessfulSyncDateTime": "2026-06-08T10:31:26.5329616Z"
    },
    {
      "tableName": "DailySummary",
      "startDateTime": "2026-06-09T14:31:22.2708973Z",
      "endDateTime": "2026-06-09T14:31:24.9183509Z",
      "status": "NotRun",
      "lastSuccessfulSyncDateTime": "2026-06-08T08:32:53.3890146Z"
    }
  ]
}

Refresh selective tables with recreate tables for a specified SQL analytics endpoint in a workspace

샘플 요청

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/sqlEndpoints/5b218778-e7a5-4d73-8187-f10824047715/refreshMetadata

{
  "recreateTables": true,
  "tables": [
    {
      "schema": "dbo",
      "tableNames": [
        "Orders",
        "OrderDetails"
      ]
    }
  ]
}

샘플 응답

상태 코드:
200 
{
  "value": [
    {
      "tableName": "Orders",
      "startDateTime": "2026-06-09T14:31:22.2708973Z",
      "endDateTime": "2026-06-09T14:31:25.9651741Z",
      "status": "Success",
      "lastSuccessfulSyncDateTime": "2026-06-09T14:31:25.9651741Z"
    },
    {
      "tableName": "OrderDetails",
      "startDateTime": "2026-06-09T14:31:22.2708973Z",
      "endDateTime": "2026-06-09T14:31:26.5329616Z",
      "status": "Success",
      "lastSuccessfulSyncDateTime": "2026-06-09T14:31:26.5329616Z"
    }
  ]
}

Refresh selective tables with user defined schemas for a specified SQL analytics endpoint in a workspace

샘플 요청

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/sqlEndpoints/5b218778-e7a5-4d73-8187-f10824047715/refreshMetadata

{
  "tables": [
    {
      "schema": "sales",
      "tableNames": [
        "Orders",
        "OrderDetails"
      ]
    },
    {
      "schema": "analytics",
      "tableNames": [
        "DailySummary"
      ]
    }
  ]
}

샘플 응답

상태 코드:
200 
{
  "value": [
    {
      "tableName": "sales.Orders",
      "startDateTime": "2026-06-09T14:31:22.2708973Z",
      "endDateTime": "2026-06-09T14:31:25.9651741Z",
      "status": "Success",
      "lastSuccessfulSyncDateTime": "2026-06-09T14:31:25.9651741Z"
    },
    {
      "tableName": "sales.OrderDetails",
      "startDateTime": "2026-06-09T14:31:22.2708973Z",
      "endDateTime": "2026-06-09T14:31:26.5329616Z",
      "status": "Success",
      "lastSuccessfulSyncDateTime": "2026-06-09T14:31:26.5329616Z"
    },
    {
      "tableName": "analytics.DailySummary",
      "startDateTime": "2026-06-09T14:31:22.2708973Z",
      "endDateTime": "2026-06-09T14:31:24.9183509Z",
      "status": "Success",
      "lastSuccessfulSyncDateTime": "2026-06-09T14:31:24.9183509Z"
    }
  ]
}

정의

Name Description
Duration

기간입니다.
ErrorRelatedResource

오류 관련 리소스 세부 정보 개체입니다.
ErrorResponse

오류 응답입니다.
ErrorResponseDetails

오류 응답 세부 정보입니다.
SqlEndpointRefreshMetadataRequest

SQL 분석 엔드포인트를 새로 고치는 요청 페이로드입니다.
SyncStatus

동기화 작업의 상태입니다. 시간이 지남에 따라 추가 SyncStatus 형식을 추가할 수 있습니다.
TableDefinition

선택적 새로 고침 범위를 지정하기 위한 스키마 및 테이블 이름 쌍입니다.
TableSyncStatus

테이블 동기화 상태 개체입니다.
TableSyncStatuses

테이블 동기화 상태 목록입니다.
TimeUnit

기간의 시간 단위입니다. 시간이 지남에 따라 추가 기간 유형을 추가할 수 있습니다.

Duration

Object

기간입니다.

Name 형식 Description
timeUnit

TimeUnit

기간의 시간 단위입니다. 시간이 지남에 따라 추가 기간 유형을 추가할 수 있습니다.
value

number

기간의 timeUnits 수입니다.

ErrorRelatedResource

Object

오류 관련 리소스 세부 정보 개체입니다.

Name 형식 Description
resourceId

string

오류와 관련된 리소스 ID입니다.
resourceType

string

오류와 관련된 리소스의 형식입니다.

ErrorResponse

Object

오류 응답입니다.

Name 형식 Description
errorCode

string

오류 조건에 대한 정보를 제공하여 서비스와 사용자 간의 표준화된 통신을 허용하는 특정 식별자입니다.
isRetriable

boolean

true이면 요청을 다시 시도 할 수 있습니다. 응답 헤더를 Retry-After 사용하여 가능한 경우 지연을 확인합니다.
message

string

사용자가 읽을 수 있는 오류 표현입니다.
moreDetails

ErrorResponseDetails[]

추가 오류 세부 정보 목록입니다.
relatedResource

ErrorRelatedResource

오류 관련 리소스 세부 정보입니다.
requestId

string (uuid)

오류와 연결된 요청의 ID입니다.

ErrorResponseDetails

Object

오류 응답 세부 정보입니다.

Name 형식 Description
errorCode

string

오류 조건에 대한 정보를 제공하여 서비스와 사용자 간의 표준화된 통신을 허용하는 특정 식별자입니다.
message

string

사용자가 읽을 수 있는 오류 표현입니다.
relatedResource

ErrorRelatedResource

오류 관련 리소스 세부 정보입니다.

SqlEndpointRefreshMetadataRequest

Object

SQL 분석 엔드포인트를 새로 고치는 요청 페이로드입니다.

Name 형식 Description
recreateTables

boolean

true로 설정하면 이 속성은 새로 고침 프로세스 중에 SQL 분석 엔드포인트의 모든 테이블을 삭제하고 다시 만들도록 시스템에 지시합니다. 예를 들어 불일치를 해결하거나 새로 고침을 새로 고치려면 원본 정의에서 테이블을 완전히 다시 작성해야 하는 경우 이 옵션을 사용합니다. 동기화 상태 재설정과 결합 tables하면 지정된 테이블로만 동기화 상태 재설정 범위가 지정됩니다. 기본값은 false입니다.
tables

TableDefinition[]

제공되면 새로 고침 범위를 나열된 테이블로만 지정합니다. 생략하거나 비우면 모든 테이블이 새로 고쳐집니다. 각 항목은 해당 스키마 아래에 새로 고칠 스키마와 하나 이상의 테이블 이름을 지정합니다. 단일 요청에서 동기화할 수 있는 최대 테이블 수는 25개입니다. 테이블 확인은 SQL 엔드포인트의 부모 항목이 스키마를 사용할 수 있는지 여부에 따라 달라집니다. 스키마 사용 항목의 경우 테이블은 호출자가 제공한 스키마를 사용하여 확인됩니다. 스키마를 사용하지 않는 항목의 경우 호출자가 제공한 스키마 값에 관계없이 모든 테이블이 기본 스키마에서 확인됩니다. 기본 스키마가 아닌 테이블은 확인할 수 없으며 오류와 함께 DeltaTableNotFound 보고됩니다.
timeout

Duration

시간이 초과되기 전의 요청 기간입니다. 기본값은 15분입니다.

SyncStatus

열거형

동기화 작업의 상태입니다. 시간이 지남에 따라 추가 SyncStatus 형식을 추가할 수 있습니다.

값 Description
Success

성공을 나타냅니다.
Failure

오류를 나타냅니다.
NotRun

작업이 실행되지 않았음을 나타냅니다.

TableDefinition

Object

선택적 새로 고침 범위를 지정하기 위한 스키마 및 테이블 이름 쌍입니다.

Name 형식 Description
schema

string

minLength: 1
maxLength: 128

테이블 확인의 스키마 이름입니다. 예약된 시스템 스키마가 아니어야 합니다.
tableNames

string[]

minLength: 1
maxLength: 128

지정된 스키마 아래에서 새로 고칠 하나 이상의 테이블 이름입니다.

TableSyncStatus

Object

테이블 동기화 상태 개체입니다.

Name 형식 Description
endDateTime

string (date-time)

YYYY-MM-DDTHH:mm:ssZ 형식을 사용하여 테이블 동기화가 UTC로 완료된 날짜 및 시간입니다.
error

ErrorResponseDetails

오류 응답 세부 정보
lastSuccessfulSyncDateTime

string (date-time)

YYYY-MM-DDTHH:mm:ssZ 형식을 사용하여 테이블 동기화가 UTC에서 성공한 날짜 및 시간입니다.
startDateTime

string (date-time)

YYYY-MM-DDTHH:mm:ssZ 형식을 사용하여 테이블 동기화가 UTC로 시작된 날짜 및 시간입니다.
status

SyncStatus

테이블이 오류 없이 동기화되었는지 여부입니다.
tableName

string

동기화된 테이블의 이름입니다. 스키마 사용 항목의 경우 테이블 이름 앞에 스키마 이름(예: "schema.tableName")이 수록됩니다.

TableSyncStatuses

Object

테이블 동기화 상태 목록입니다.

Name 형식 Description
value

TableSyncStatus[]

테이블 동기화 상태 목록입니다.

TimeUnit

열거형

기간의 시간 단위입니다. 시간이 지남에 따라 추가 기간 유형을 추가할 수 있습니다.

값 Description
Seconds

기간(초)입니다.
Minutes

기간(분)입니다.
Hours

기간(시간)입니다.
Days

기간(일)입니다.