จัดการและรีเฟรชมุมมองทะเลสาบที่เป็นรูปธรรมใน Fabric ด้วย API

Microsoft Fabric REST APIs ช่วยให้คุณจัดการและรีเฟรชมุมมองทะเลสาบที่สร้างขึ้นจริง (MLVs) ได้ด้วยโปรแกรม คุณสามารถดําเนินการรีเฟรชสายข้อมูลโดยอัตโนมัติและรวมเข้ากับเครื่องมือและระบบอื่นๆ

ข้อกําหนดเบื้องต้น

ก่อนที่คุณจะใช้ REST API ของมุมมอง lake ที่เป็นรูปธรรม ให้ดําเนินการข้อกําหนดเบื้องต้นเหล่านี้ให้เสร็จสมบูรณ์:

ลงทะเบียนแอปพลิเคชันด้วย Microsoft Entra ID ด้วยข้อมูลประจําตัวที่เหมาะสม รับโทเค็นเพื่อการเข้าถึงที่มี ขอบเขต ที่เหมาะสมและส่งผ่านในส่วน Authorization หัวของทุกคําขอ
เปลี่ยนตัวยึดตําแหน่งรวมถึง{WORKSPACE_ID}และ{LAKEHOUSE_ID}ด้วยความเหมาะสมWorkspaceIdและLakehouseId หากต้องการค้นหารหัสเหล่านี้ ให้เปิดเลคเฮาส์ในพอร์ทัล Fabric — URL ประกอบด้วยทั้งสองอย่าง: https://app.fabric.microsoft.com/groups/{WORKSPACE_ID}/lakehouses/{LAKEHOUSE_ID} หรือคุณสามารถแสดงรายการพื้นที่ทํางานและเลคเฮาส์โดยใช้ Fabric REST API เพื่อเข้าถึงโดยทางโปรแกรม

การดําเนินการ ของตัวจัดกําหนดการงาน ต่อไปนี้พร้อมใช้งานสําหรับมุมมองทะเลสาบที่เป็นรูปธรรม

การดำเนินการ	คำอธิบาย
สร้างกําหนดการรีเฟรชสําหรับ MLV	สร้างกําหนดการสําหรับการรีเฟรช MLV เป็นระยะ
รับกําหนดการสําหรับ MLV	รับรายละเอียดของกําหนดการรีเฟรชที่มีอยู่
รายการกําหนดการสําหรับ MLV	แสดงรายการกําหนดการรีเฟรชทั้งหมด
อัปเดตกําหนดการรีเฟรชสําหรับ MLV	อัปเดตกําหนดการรีเฟรชที่มีอยู่
ลบกําหนดการรีเฟรชสําหรับ MLV	ลบกําหนดการรีเฟรช
เรียกใช้การรีเฟรชตามความต้องการสําหรับ MLV	เรียกใช้การรีเฟรช MLV ทันที
แสดงรายการอินสแตนซ์งานสําหรับ MLV	แสดงรายการอินสแตนซ์งานรีเฟรชทั้งหมด
รับรายละเอียดอินสแตนซ์งานสําหรับ MLV	รับรายละเอียดของงานรีเฟรชเฉพาะ เช่น สถานะ
ยกเลิกอินสแตนซ์งานสําหรับ MLV	ยกเลิกงานรีเฟรชที่กําลังดําเนินการอยู่

สําหรับข้อมูลเพิ่มเติม โปรดดู ตัวจัดกําหนดการงาน ที่ {item} Lakehouse และ {jobType} is RefreshMaterializedLakeViews.

ข้อกําหนดการดําเนินการ MLV คือการกําหนดค่าที่บันทึกไว้ซึ่งระบุว่ามุมมองทะเลสาบใดที่จะรีเฟรช เลคเฮาส์อัปสตรีมที่จะรวม และโหมดรีเฟรชและสภาพแวดล้อม Spark ที่จะใช้ กําหนดชุดย่อยของ สายข้อมูลที่ สามารถรีเฟรชได้อย่างอิสระ

การดําเนินการต่อไปนี้พร้อมใช้งานสําหรับข้อกําหนดการดําเนินการ MLV

การดำเนินการ	คำอธิบาย
สร้างคําจํากัดความการดําเนินการ MLV	สร้างข้อกําหนดการดําเนินการ MLV ใหม่
แสดงรายการคําจํากัดความการดําเนินการ MLV	แสดงรายการคําจํากัดความการดําเนินการ MLV ทั้งหมด
รับคําจํากัดความการดําเนินการ MLV	ดูรายละเอียดของคําจํากัดความการดําเนินการ MLV ที่มีอยู่
อัปเดตคําจํากัดความการดําเนินการ MLV	อัปเดตข้อกําหนดการดําเนินการ MLV ที่มีอยู่
ลบคําจํากัดความการดําเนินการ MLV	ลบข้อกําหนดการดําเนินการ MLV

สําหรับข้อมูลเพิ่มเติม โปรดดู มุมมองทะเลสาบที่เป็นรูปธรรม

ไดอะแกรมต่อไปนี้แสดงวิธีการรีเฟรชมุมมองทะเลสาบที่เป็นรูปธรรม โดยมีหรือไม่มีข้อกําหนดการดําเนินการ MLV

กรณีการใช้งาน 1: รีเฟรช MLV ทั้งหมดในเลคเฮาส์ (ค่าเริ่มต้น)

กรณีการใช้งาน 2: รีเฟรช MLV เฉพาะหรือชุดย่อยของสายข้อมูล

Note

สถานการณ์เหล่านี้ครอบคลุมตัวอย่างการใช้งานเฉพาะสําหรับมุมมองทะเลสาบที่เป็นภาพ ตัวอย่างสําหรับ Api ของรายการ Fabric ทั่วไปไม่ได้รวมไว้

ตัวอย่างการรีเฟรชมุมมองทะเลสาบที่เป็นรูปธรรมโดยใช้ API

แต่ละตัวอย่างแสดงเมธอด HTTP, URL จุดสิ้นสุด และคําขอตัวอย่าง/ส่วนข้อมูลการตอบสนอง

สร้างกําหนดการรีเฟรชสําหรับ MLV

สร้างกําหนดการสําหรับการรีเฟรชสายข้อมูลเป็นงวด หากต้องการรีเฟรชเฉพาะชุดย่อยของสายข้อมูล ให้ระบุ 'mlvExecutionDefinitionId' ในexecutionData สําหรับข้อมูลเพิ่มเติม โปรดดู สร้างกําหนดการรีเฟรชมุมมองทะเลสาบที่เป็นรูปธรรม และรับข้อกําหนดการดําเนินการ MLV

ตัวอย่างคําขอที่ไม่มีคําจํากัดความการดําเนินการ MLV:

POST https://api.fabric.microsoft.com/v1/workspaces/{WORKSPACE_ID}/lakehouses/{LAKEHOUSE_ID}/jobs/RefreshMaterializedLakeViews/schedules

{
  "enabled": true,
  "configuration": {
    "startDateTime": "YYYY-MM-DDTHH:mm:ss",
    "endDateTime": "YYYY-MM-DDTHH:mm:ss",
    "localTimeZoneId": "Central Standard Time",
    "type": "Cron",
    "interval": 10
  }
}

ตัวอย่างคําขอที่มีคําจํากัดความการดําเนินการ MLV:

POST https://api.fabric.microsoft.com/v1/workspaces/{WORKSPACE_ID}/lakehouses/{LAKEHOUSE_ID}/jobs/RefreshMaterializedLakeViews/schedules

{
  "enabled": true,
  "configuration": {
    "startDateTime": "YYYY-MM-DDTHH:mm:ss",
    "endDateTime": "YYYY-MM-DDTHH:mm:ss",
    "localTimeZoneId": "Central Standard Time",
    "type": "Cron",
    "interval": 10
  },
  "executionData": {
    "mlvExecutionDefinitionId": "<mlvExecutionDefinitionId>"
  }
}

ตัวอย่างการตอบสนอง:

รหัสสถานะ: 201 สร้างแล้ว

Location: https://api.fabric.microsoft.com/v1/workspaces/{WORKSPACE_ID}/lakehouses/{LAKEHOUSE_ID}/jobs/RefreshMaterializedLakeViews/schedules/<scheduleId>

{
  "id": "<scheduleId>",
  "enabled": true,
  "createdDateTime": "YYYY-MM-DDTHH:mm:ss.xxxxxxx",
  "configuration": {
    "startDateTime": "YYYY-MM-DDTHH:mm:ss",
    "endDateTime": "YYYY-MM-DDTHH:mm:ss",
    "localTimeZoneId": "Central Standard Time",
    "type": "Cron",
    "interval": 10
  },
  "owner": {
    "id": "<ownerId>",
    "type": "User"
  }
}

รับกําหนดการสําหรับ MLV

รับรายละเอียดของกําหนดการรีเฟรชที่มีอยู่ สําหรับข้อมูลเพิ่มเติม โปรดดู รับกําหนดการรายการด้วย {item} เป็น Lakehouse และ {jobType} เป็นRefreshMaterializedLakeViews

คําขอตัวอย่าง:

GET https://api.fabric.microsoft.com/v1/workspaces/{WORKSPACE_ID}/lakehouses/{LAKEHOUSE_ID}/jobs/RefreshMaterializedLakeViews/schedules/{scheduleId}

ตัวอย่างการตอบสนอง:

รหัสสถานะ: 200 ตกลง

{
  "id": "<scheduleId>",
  "enabled": true,
  "createdDateTime": "YYYY-MM-DDTHH:mm:ss.xxxxxxx",
  "configuration": {
    "startDateTime": "YYYY-MM-DDTHH:mm:ss",
    "endDateTime": "YYYY-MM-DDTHH:mm:ss",
    "localTimeZoneId": "Central Standard Time",
    "type": "Cron",
    "interval": 10
  },
  "executionData": {
    "mlvExecutionDefinitionId": "<mlvExecutionDefinitionId>"
  },
  "owner": {
    "id": "<ownerId>",
    "type": "User"
  }
}

รายการกําหนดการสําหรับ MLV

แสดงรายการกําหนดการรีเฟรชทั้งหมด สําหรับข้อมูลเพิ่มเติม โปรดดู กําหนดการ{item}รายการที่มี เป็น Lakehouse และ {jobType} เป็นRefreshMaterializedLakeViews

คําขอตัวอย่าง:

GET https://api.fabric.microsoft.com/v1/workspaces/{WORKSPACE_ID}/lakehouses/{LAKEHOUSE_ID}/jobs/RefreshMaterializedLakeViews/schedules

ตัวอย่างการตอบสนอง:

รหัสสถานะ: 200 ตกลง

{
  "value": [
    {
      "id": "<scheduleId_1>",
      "enabled": true,
      "createdDateTime": "YYYY-MM-DDTHH:mm:ss.xxxxxxx",
      "configuration": {
        "startDateTime": "YYYY-MM-DDTHH:mm:ss",
        "endDateTime": "YYYY-MM-DDTHH:mm:ss",
        "localTimeZoneId": "Central Standard Time",
        "type": "Weekly",
        "weekdays": [
          "Monday",
          "Tuesday"
        ],
        "times": [
          "HH:mm",
          "HH:mm"
        ]
      },
      "owner": {
        "id": "<ownerId>",
        "type": "User"
      }
    },
    {
      "id": "<scheduleId_2>",
      "enabled": true,
      "createdDateTime": "YYYY-MM-DDTHH:mm:ss.xxxxxxx",
      "configuration": {
        "startDateTime": "YYYY-MM-DDTHH:mm:ss",
        "endDateTime": "YYYY-MM-DDTHH:mm:ss",
        "localTimeZoneId": "Central Standard Time",
        "type": "Daily",
        "times": [
          "HH:mm",
          "HH:mm"
        ]
      },
      "owner": {
        "id": "<ownerId>",
        "type": "User"
      }
    }
  ]
}

อัปเดตกําหนดการรีเฟรชสําหรับ MLV

อัปเดตกําหนดการรีเฟรชที่มีอยู่ สําหรับข้อมูลเพิ่มเติม โปรดดู อัปเดตกําหนดการรีเฟรช Lake Views ที่เป็นรูปธรรม

คําขอตัวอย่าง:

PATCH https://api.fabric.microsoft.com/v1/workspaces/{WORKSPACE_ID}/lakehouses/{LAKEHOUSE_ID}/jobs/RefreshMaterializedLakeViews/schedules/{scheduleId}

{
  "enabled": true,
  "configuration": {
    "startDateTime": "YYYY-MM-DDTHH:mm:ss",
    "endDateTime": "YYYY-MM-DDTHH:mm:ss",
    "localTimeZoneId": "Central Standard Time",
    "type": "Cron",
    "interval": 10
  },
  "executionData": {
    "mlvExecutionDefinitionId": "<mlvExecutionDefinitionId>"
  }
}

ตัวอย่างการตอบสนอง:

รหัสสถานะ: 200 ตกลง

{
  "id": "<scheduleId>",
  "enabled": true,
  "createdDateTime": "YYYY-MM-DDTHH:mm:ss.xxxxxxx",
  "configuration": {
    "startDateTime": "YYYY-MM-DDTHH:mm:ss",
    "endDateTime": "YYYY-MM-DDTHH:mm:ss",
    "localTimeZoneId": "Central Standard Time",
    "type": "Cron",
    "interval": 10
  },
  "executionData": {
    "mlvExecutionDefinitionId": "<mlvExecutionDefinitionId>"
  },
  "owner": {
    "id": "<ownerId>",
    "type": "User"
  }
}

ลบกําหนดการรีเฟรชสําหรับ MLV

ลบกําหนดการรีเฟรช สําหรับข้อมูลเพิ่มเติม โปรดดู ลบกําหนดการรีเฟรช Lake Views ที่เป็นรูปธรรม

คําขอตัวอย่าง:

DELETE https://api.fabric.microsoft.com/v1/workspaces/{WORKSPACE_ID}/lakehouses/{LAKEHOUSE_ID}/jobs/RefreshMaterializedLakeViews/schedules/{scheduleId}

ตัวอย่างการตอบสนอง:

รหัสสถานะ: 200 ตกลง

เรียกใช้การรีเฟรชตามความต้องการสําหรับ MLV

เรียกใช้การรีเฟรชสายข้อมูลทันที หากต้องการรีเฟรชเฉพาะชุดย่อยของสายข้อมูล ให้ระบุ 'mlvExecutionDefinitionId' ในexecutionData สําหรับข้อมูลเพิ่มเติม โปรดดู เรียกใช้ตามความต้องการ รีเฟรชมุมมองทะเลสาบที่เป็นรูปธรรม และรับคําจํากัดความการดําเนินการ MLV

ตัวอย่างคําขอที่ไม่มีคําจํากัดความการดําเนินการ MLV:

POST https://api.fabric.microsoft.com/v1/workspaces/{WORKSPACE_ID}/lakehouses/{LAKEHOUSE_ID}/jobs/RefreshMaterializedLakeViews/instances

ตัวอย่างคําขอที่มีคําจํากัดความการดําเนินการ MLV:

POST https://api.fabric.microsoft.com/v1/workspaces/{WORKSPACE_ID}/lakehouses/{LAKEHOUSE_ID}/jobs/RefreshMaterializedLakeViews/instances

{
  "executionData": {
    "mlvExecutionDefinitionId": "<mlvExecutionDefinitionId>"
  }
}

ตัวอย่างการตอบสนอง:

รหัสสถานะ: 202 Accepted

Location: https://api.fabric.microsoft.com/v1/workspaces/<WORKSPACE_ID>/lakehouses/<LAKEHOUSE_ID>/jobs/instances/<jobInstanceId>
Retry-After: 60

ด้วย Location ส่วนหัว คุณสามารถใช้ รับอินสแตนซ์งานสินค้า เพื่อตรวจสอบสถานะงาน หรือ ยกเลิกอินสแตนซ์งานสินค้า เพื่อยกเลิกการรัน

แสดงรายการอินสแตนซ์งานสําหรับ MLV

แสดงรายการอินสแตนซ์งานรีเฟรชทั้งหมด สําหรับข้อมูลเพิ่มเติม โปรดดู อินสแตนซ์{item}งานรายการที่มี as Lakehouse และ {jobType}RefreshMaterializedLakeViews. สถานะงานสะท้อนถึงสถานะในฮับการตรวจสอบ

คําขอตัวอย่าง:

GET https://api.fabric.microsoft.com/v1/workspaces/{WORKSPACE_ID}/lakehouses/{LAKEHOUSE_ID}/jobs/RefreshMaterializedLakeViews/instances

ตัวอย่างการตอบสนอง:

รหัสสถานะ: 200 ตกลง

{
  "value": [
    {
      "id": "<jobInstanceId_1>",
      "itemId": "<LAKEHOUSE_ID>",
      "jobType": "RefreshMaterializedLakeViews",
      "invokeType": "Manual",
      "status": "<status>",
      "rootActivityId": "<rootActivityId_1>",
      "startTimeUtc": "YYYY-MM-DDTHH:mm:ss.xxxxxxx",
      "endTimeUtc": "YYYY-MM-DDTHH:mm:ss.xxxxxxx",
      "failureReason": null
    },
    {
      "id": "<jobInstanceId_2>",
      "itemId": "<LAKEHOUSE_ID>",
      "jobType": "RefreshMaterializedLakeViews",
      "invokeType": "Scheduled",
      "status": "<status>",
      "rootActivityId": "rootActivityId_2",
      "startTimeUtc": "YYYY-MM-DDTHH:mm:ss.xxxxxxx",
      "endTimeUtc": "YYYY-MM-DDTHH:mm:ss.xxxxxxx",
      "failureReason": null
    }
  ]
}

รับรายละเอียดอินสแตนซ์งานสําหรับ MLV

รับสถานะและรายละเอียดสําหรับอินสแตนซ์งานรีเฟรชเฉพาะ สําหรับข้อมูลเพิ่มเติม โปรดดู รับอินสแตนซ์งานรายการ ด้วย {item} as Lakehouse สถานะงานสะท้อนถึงสถานะในฮับการตรวจสอบ

คําขอตัวอย่าง:

GET https://api.fabric.microsoft.com/v1/workspaces/{WORKSPACE_ID}/lakehouses/{LAKEHOUSE_ID}/jobs/instances/{jobInstanceId}

ตัวอย่างการตอบสนอง:

รหัสสถานะ: 200 ตกลง

{
  "id": "<id>",
  "itemId": "<itemId>",
  "jobType": "RefreshMaterializedLakeViews",
  "invokeType": "<invokeType>",
  "status": "<status>",
  "rootActivityId": "<rootActivityId>",
  "startTimeUtc": "YYYY-MM-DDTHH:mm:ss.xxxxxxx",
  "endTimeUtc": "YYYY-MM-DDTHH:mm:ss.xxxxxxx",
  "failureReason": null
}

ยกเลิกอินสแตนซ์งานสําหรับ MLV

ยกเลิกงานรีเฟรชที่กําลังดําเนินการอยู่ สําหรับข้อมูลเพิ่มเติม โปรดดู ยกเลิกอินสแตนซ์งานสินค้า ด้วย {item} as Lakehouse

คําขอตัวอย่าง:

POST https://api.fabric.microsoft.com/v1/workspaces/{WORKSPACE_ID}/lakehouses/{LAKEHOUSE_ID}/jobs/instances/{jobInstanceId}/cancel

ตัวอย่างการตอบสนอง:

รหัสสถานะ: 202 Accepted

Location: https://api.fabric.microsoft.com/v1/workspaces/<WORKSPACE_ID>/lakehouses/<LAKEHOUSE_ID>/jobs/instances/<jobInstanceId>
Retry-After: 60

ตัวอย่างการใช้ API คําจํากัดความการดําเนินการ MLV

สร้างคําจํากัดความการดําเนินการ MLV

สร้างข้อกําหนดการดําเนินการ MLV ใหม่ที่ระบุว่า MLV และเลคเฮาส์อัปสตรีมที่จะรวมไว้ พร้อมกับโหมดรีเฟรชและสภาพแวดล้อม Spark สําหรับข้อมูลเพิ่มเติม โปรดดู สร้างคําจํากัดความการดําเนินการ Mlv

คําขอตัวอย่าง:

POST https://api.fabric.microsoft.com/v1/workspaces/{WORKSPACE_ID}/lakehouses/{LAKEHOUSE_ID}/mlvexecutiondefinitions

{
  "displayName": "Gold Chain – Sales",
  "description": "Nightly refresh for the Sales gold-layer views",
  "settings": {
    "environment": {
      "referenceType": "ById",
      "itemId": "<ENVIRONMENT_ID>",
      "workspaceId": "<ENVIRONMENT_WORKSPACE_ID>"
    },
    "refreshMode": "Optimal"
  },
  "currentLakehouseExecutionContext": {
    "mode": "Selected",
    "selectedMlvs": [
      "dbo.gold_sales_summary",
      "dbo.gold_sales_daily"
    ]
  },
  "extendedLineageExecutionContext": {
    "mode": "All"
  }
}

ตัวอย่างการตอบสนอง:

รหัสสถานะ: 201 สร้างแล้ว

Location: https://api.fabric.microsoft.com/v1/workspaces/{WORKSPACE_ID}/lakehouses/{LAKEHOUSE_ID}/mlvexecutiondefinitions/<mlvExecutionDefinitionId>

{
  "id": "<mlvExecutionDefinitionId>",
  "displayName": "Gold Chain – Sales",
  "description": "Nightly refresh for the Sales gold-layer views",
  "settings": {
    "environment": {
      "referenceType": "ById",
      "itemId": "<ENVIRONMENT_ID>",
      "workspaceId": "<ENVIRONMENT_WORKSPACE_ID>"
    },
    "refreshMode": "Optimal"
  },
  "currentLakehouseExecutionContext": {
    "mode": "Selected",
    "selectedMlvs": [
      "dbo.gold_sales_summary",
      "dbo.gold_sales_daily"
    ]
  },
  "extendedLineageExecutionContext": {
    "mode": "All"
  }
}

แสดงรายการคําจํากัดความการดําเนินการ MLV

แสดงรายการคําจํากัดความการดําเนินการ MLV ทั้งหมด สําหรับข้อมูลเพิ่มเติม โปรดดู แสดงรายการคําจํากัดความการดําเนินการ Mlv

คําขอตัวอย่าง:

GET https://api.fabric.microsoft.com/v1/workspaces/{WORKSPACE_ID}/lakehouses/{LAKEHOUSE_ID}/mlvexecutiondefinitions

ตัวอย่างการตอบสนอง:

รหัสสถานะ: 200 ตกลง

{
  "value": [
    {
      "id": "<mlvExecutionDefinitionId_1>",
      "displayName": "Gold Chain – Sales",
      "description": "Nightly refresh for the Sales gold-layer views",
      "settings": {
        "environment": {
          "referenceType": "ById",
          "itemId": "<ENVIRONMENT_ID>",
          "workspaceId": "<ENVIRONMENT_WORKSPACE_ID>"
        },
        "refreshMode": "Optimal"
      },
      "currentLakehouseExecutionContext": {
        "mode": "Selected",
        "selectedMlvs": [
          "dbo.gold_sales_summary",
          "dbo.gold_sales_daily"
        ]
      },
      "extendedLineageExecutionContext": {
        "mode": "All"
      }
    },
    {
      "id": "<mlvExecutionDefinitionId_2>",
      "displayName": "Silver Chain – Customers",
      "currentLakehouseExecutionContext": {
        "mode": "All"
      }
    }
  ]
}

รับคําจํากัดความการดําเนินการ MLV

รับรายละเอียดของข้อกําหนดการดําเนินการ MLV ที่มีอยู่ รวมถึง MLV ที่จะรีเฟรช เลคเฮาส์อัปสตรีมที่จะรวม โหมดรีเฟรช และสภาพแวดล้อม Spark สําหรับข้อมูลเพิ่มเติม โปรดดู รับคําจํากัดความการดําเนินการ Mlv

คําขอตัวอย่าง:

GET https://api.fabric.microsoft.com/v1/workspaces/{WORKSPACE_ID}/lakehouses/{LAKEHOUSE_ID}/mlvexecutiondefinitions/{mlvExecutionDefinitionId}

ตัวอย่างการตอบสนอง:

รหัสสถานะ: 200 ตกลง

{
  "id": "<mlvExecutionDefinitionId>",
  "displayName": "Gold Chain – Sales",
  "description": "Nightly refresh for the Sales gold-layer views",
  "settings": {
    "environment": {
      "referenceType": "ById",
      "itemId": "<ENVIRONMENT_ID>",
      "workspaceId": "<ENVIRONMENT_WORKSPACE_ID>"
    },
    "refreshMode": "Optimal"
  },
  "currentLakehouseExecutionContext": {
    "mode": "Selected",
    "selectedMlvs": [
      "dbo.gold_sales_summary",
      "dbo.gold_sales_daily"
    ]
  },
  "extendedLineageExecutionContext": {
    "mode": "All"
  }
}

อัปเดตคําจํากัดความการดําเนินการ MLV

อัปเดตข้อกําหนดการดําเนินการ MLV ที่มีอยู่ เฉพาะเขตข้อมูลที่ระบุในเนื้อความของคําขอเท่านั้นที่จะถูกอัปเดต เขตข้อมูลที่ถูกละเว้นจะคงค่าเดิมไว้ สําหรับข้อมูลเพิ่มเติม โปรดดู อัปเดตคําจํากัดความการดําเนินการ Mlv

คําขอตัวอย่าง:

PATCH https://api.fabric.microsoft.com/v1/workspaces/{WORKSPACE_ID}/lakehouses/{LAKEHOUSE_ID}/mlvexecutiondefinitions/{mlvExecutionDefinitionId}

{
  "displayName": "Updated Gold Chain – Sales",
  "settings": {
    "refreshMode": "Full"
  },
  "currentLakehouseExecutionContext": {
    "mode": "All"
  },
  "extendedLineageExecutionContext": {
    "mode": "Selected",
    "selectedLakehouses": [
      {
        "referenceType": "ById",
        "itemId": "<UPSTREAM_LAKEHOUSE_ID>",
        "workspaceId": "<UPSTREAM_WORKSPACE_ID>"
      }
    ]
  }
}

ตัวอย่างการตอบสนอง:

รหัสสถานะ: 200 ตกลง

{
  "id": "<mlvExecutionDefinitionId>",
  "displayName": "Updated Gold Chain – Sales",
  "description": "Nightly refresh for the Sales gold-layer views",
  "settings": {
    "environment": {
      "referenceType": "ById",
      "itemId": "<ENVIRONMENT_ID>",
      "workspaceId": "<ENVIRONMENT_WORKSPACE_ID>"
    },
    "refreshMode": "Full"
  },
  "currentLakehouseExecutionContext": {
    "mode": "All"
  },
  "extendedLineageExecutionContext": {
    "mode": "Selected",
    "selectedLakehouses": [
      {
        "referenceType": "ById",
        "itemId": "<UPSTREAM_LAKEHOUSE_ID>",
        "workspaceId": "<UPSTREAM_WORKSPACE_ID>"
      }
    ]
  }
}

ลบคําจํากัดความการดําเนินการ MLV

ลบข้อกําหนดการดําเนินการ MLV กําหนดการใดๆ ที่เชื่อมโยงกับมันจะถูกลบออกด้วย สําหรับข้อมูลเพิ่มเติม โปรดดู ลบคําจํากัดความการดําเนินการ Mlv

คําขอตัวอย่าง:

DELETE https://api.fabric.microsoft.com/v1/workspaces/{WORKSPACE_ID}/lakehouses/{LAKEHOUSE_ID}/mlvexecutiondefinitions/{mlvExecutionDefinitionId}

ตัวอย่างการตอบสนอง:

รหัสสถานะ: 200 ตกลง

ข้อจำกัดที่ทราบ

ข้อจํากัดต่อไปนี้นําไปใช้กับมุมมองทะเลสาบที่เป็นรูปธรรม REST API:

ขีดจํากัดของ Job Scheduler API:
- ตัวจัดกําหนดการงานบังคับใช้ขีดจํากัดจํานวนกําหนดการที่สามารถกําหนดค่าได้ต่อเลคเฮาส์
- API ตัวจัดกําหนดการงาน ส่งคืนงานที่เสร็จสมบูรณ์และใช้งานอยู่จํานวนจํากัด ซึ่งอาจส่งผลต่อการมองเห็นการดําเนินการในอดีตหรือการดําเนินการพร้อมกัน
- ขีดจํากัดการควบคุมสําหรับ API สาธารณะของ Fabric มีผลกับ API มุมมองทะเลสาบที่เป็นรูปธรรม
การแสดงสถานะงาน: สถานะที่ส่งคืนโดย อินสแตนซ์งานไอเท็มในรายการ และรับ อินสแตนซ์งานไอเท็ม สะท้อนถึงสถานะในฮับมอนิเตอร์ อาจแตกต่างจากสถานะ ประวัติการเรียกใช้ มุมมองทะเลสาบที่เป็นรูปธรรม (เช่น ข้ามไปแล้ว จะปรากฏเป็น ยกเลิก ในฮับการตรวจสอบ)
ขีดจํากัดการรีเฟรช: สําหรับข้อจํากัดในการรีเฟรช โปรดดู สิทธิ์และข้อจํากัด

คำติชม

หน้านี้มีประโยชน์หรือไม่

Last updated on 2026-07-01

จัดการและรีเฟรชมุมมองทะเลสาบที่เป็นรูปธรรมใน Fabric ด้วย API

ข้อกําหนดเบื้องต้น

ตัวอย่างการรีเฟรชมุมมองทะเลสาบที่เป็นรูปธรรมโดยใช้ API

สร้างกําหนดการรีเฟรชสําหรับ MLV

รับกําหนดการสําหรับ MLV

รายการกําหนดการสําหรับ MLV

อัปเดตกําหนดการรีเฟรชสําหรับ MLV

ลบกําหนดการรีเฟรชสําหรับ MLV

เรียกใช้การรีเฟรชตามความต้องการสําหรับ MLV

แสดงรายการอินสแตนซ์งานสําหรับ MLV

รับรายละเอียดอินสแตนซ์งานสําหรับ MLV

ยกเลิกอินสแตนซ์งานสําหรับ MLV

ตัวอย่างการใช้ API คําจํากัดความการดําเนินการ MLV

สร้างคําจํากัดความการดําเนินการ MLV

แสดงรายการคําจํากัดความการดําเนินการ MLV

รับคําจํากัดความการดําเนินการ MLV

อัปเดตคําจํากัดความการดําเนินการ MLV

ลบคําจํากัดความการดําเนินการ MLV

ข้อจำกัดที่ทราบ

เนื้อหาที่เกี่ยวข้อง

คำติชม

แหล่งทรัพยากรเพิ่มเติม