คุณสมบัติของชุดข้อมูลDataset properties

V1 ปัจจุบันของชุดข้อมูล API จะสร้างชุดข้อมูลด้วยชื่อและคอลเลกชันของตารางได้เท่านั้นThe current v1 of datasets API only allows for a dataset to be created with a name and a collection of tables. แต่ละตารางสามารถมีชื่อและคอลเลกชันของคอลัมน์Each table can have a name and a collection of columns. แต่ละคอลัมน์มีชื่อและชนิดข้อมูลEach column has a name and datatype. เราจะขยายคุณสมบัติเหล่านี้ด้วยการสนับสนุนให้มีหน่วยวัดและความสัมพันธ์ระหว่างตารางWe are expanding these properties most notably with support for measures and relationships between tables. รายการทั้งหมดของคุณสมบัติที่ได้รับการสนับสนุนสำหรับรุ่นนี้มีดังนี้:The complete list of supported properties for this release is as follows:

ข้อสำคัญ

สามารถเข้าถึงได้ที่หน้ากลุ่มการดำเนินการชุดข้อมูลได้It can be accessed at the Datasets Operation Groups page.

ชุดข้อมูลDataset

ชื่อName ประเภทType คำอธิบายDescription อ่านอย่างเดียวRead Only บังคับRequired
idid GUIDGuid ตัวระบุชุดข้อมูลทั้งระบบSystem wide unique identifier for the dataset. เป็นจริงTrue เป็นเท็จFalse
namename สตริงString ชุดข้อมูลที่ผู้ใช้กำหนดชื่อเองUser defined name of the dataset. เป็นเท็จFalse เป็นจริงTrue
ตารางtables ตารางTable[] คอลเลกชันของตารางCollection of tables. เป็นเท็จFalse เป็นเท็จFalse
ความสัมพันธ์relationships ความสัมพันธ์Relationship[] คอลเลกชันของความสัมพันธ์ระหว่างตารางCollection of relationships between tables. เป็นเท็จFalse เป็นเท็จFalse
defaultModedefaultMode สตริงString กำหนดว่า ชุดข้อมูลมีการส่งแบบพุช สตรีม หรือทั้งสองอย่าง ด้วยค่าของ "การส่งแบบพุช" "สตรีมมิ่ง" "Push" และ "Streaming" หรือไม่Determines whether the dataset is pushed, streamed, or both, with values of "Push" and "Streaming." เป็นเท็จFalse เป็นเท็จFalse

TableTable

ชื่อName ประเภทType คำอธิบายDescription อ่านอย่างเดียวRead Only บังคับRequired
namename สตริงString ชื่อตารางที่ผู้ใช้กำหนดเองUser defined name of the table. นอกจากนี้ยังใช้เป็นตัวระบุตารางด้วยIt is also used as the identifier of the table. เป็นเท็จFalse เป็นจริงTrue
คอลัมน์columns คอลัมน์column[] คอลเลกชันของตารางCollection of columns. เป็นเท็จFalse เป็นจริงTrue
หน่วยวัดmeasures หน่วยวัดmeasure[] คอลเลกชันของตารางCollection of measures. เป็นเท็จFalse เป็นเท็จFalse
isHiddenisHidden บูลีนBoolean ถ้าเป็นจริง ตารางจะถูกซ่อนจากเครื่องมือไคลเอ็นต์If true, table will be hidden from client tools. เป็นเท็จFalse เป็นเท็จFalse

คอลัมน์Column

ชื่อName ประเภทType คำอธิบายDescription อ่านอย่างเดียวRead Only บังคับRequired
namename สตริงString ชื่อคอลัมน์ที่ผู้ใช้กำหนดเองUser defined name of the column. เป็นเท็จFalse เป็นจริงTrue
ชนิดข้อมูลdataType สตริงString ชนิดข้อมูล EDMที่ได้รับการสนับสนุนและข้อจำกัดSupported EDM data types and restrictions. ดูข้อจำกัดชนิดของข้อมูลSee Data type restrictions. เป็นเท็จFalse เป็นจริงTrue
formatStringformatString สตริงString สตริงที่อธิบายว่า ควรจัดรูปแบบค่าอย่างไรเมื่อแสดงค่านั้นA string describing how the value should be formatted when it is displayed. เมื่อต้องการเรียนรู้เพิ่มเติมเกี่ยวกับการจัดรูปแบบสตริง ดูเนื้อหาFORMAT_STRINGTo learn more about string formatting, see FORMAT_STRING Contents. เป็นเท็จFalse เป็นเท็จFalse
sortByColumnsortByColumn สตริงString ชื่อสตริงของคอลัมน์หนึ่งในตารางเดียวกันจะถูกใช้เพื่อจัดลำดับคอลัมน์ปัจจุบันString name of a column in the same table to be used to order the current column. เป็นเท็จFalse เป็นเท็จFalse
dataCategorydataCategory สตริงString ค่าสตริงที่จะใช้กับประเภทของข้อมูลซึ่งอธิบายเกี่ยวกับข้อมูลภายในคอลัมน์นี้String value to be used for the data category which describes the data within this column. ค่าบางค่าทั่วไปรวมถึง: ที่อยู่ เมือง ทวีป ประเทศ รูปภาพ ImageUrl ละติจูด ลองติจูด องค์กร ตำแหน่ง รหัสไปรษณีย์ รัฐหรือมณฑล WebUrlSome common values include: Address, City, Continent, Country, Image, ImageUrl, Latitude, Longitude, Organization, Place, PostalCode, StateOrProvince, WebUrl เป็นเท็จFalse เป็นเท็จFalse
isHiddenisHidden บูลีนBoolean คุณสมบัติที่ระบุว่าคอลัมน์ถูกซ่อนจากมุมมองหรือไม่Property indicating if the column is hidden from view. ค่าเริ่มต้นเป็นเท็จDefault is false. เป็นเท็จFalse เป็นเท็จFalse
summarizeBysummarizeBy สตริงString วิธีการรวมแบบเริ่มต้นสำหรับคอลัมน์Default aggregation method for the column. ค่า รวมถึง: ค่าเริ่มต้น ไม่มีค่า ผลรวม ค่าน้อยสุด ค่าสูงสุด จำนวนนับ ค่าเฉลี่ย distinctCountValues include: default, none, sum, min, max, count, average, distinctCount เป็นเท็จFalse เป็นเท็จFalse

หน่วยวัดMeasure

ชื่อName ประเภทType คำอธิบายDescription อ่านอย่างเดียวRead Only บังคับRequired
namename สตริงString ชื่อหน่วยวัดที่ผู้ใช้กำหนดเองUser defined name of the measure. เป็นเท็จFalse เป็นจริงTrue
นิพจน์expression สตริงString นิพจน์ DAX ถูกต้องA valid DAX expression. เป็นเท็จFalse เป็นจริงTrue
formatStringformatString สตริงString สตริงที่อธิบายว่า ควรจัดรูปแบบค่าอย่างไรเมื่อแสดงค่านั้นA string describing how the value should be formatted when it is displayed. เมื่อต้องการเรียนรู้เพิ่มเติมเกี่ยวกับการจัดรูปแบบสตริง ดูเนื้อหาFORMAT_STRINGTo learn more about string formatting, see FORMAT_STRING Contents. เป็นเท็จFalse เป็นเท็จFalse
isHiddenisHidden สตริงString ถ้าเป็นจริง ตารางจะถูกซ่อนจากเครื่องมือไคลเอ็นต์If true, table will be hidden from client tools. เป็นเท็จFalse เป็นเท็จFalse

ความสัมพันธ์Relationship

ชื่อName ประเภทType คำอธิบายDescription อ่านอย่างเดียวRead Only บังคับRequired
namename สตริงString ชื่อความสัมพันธ์ที่ผู้ใช้กำหนดเองUser defined name of the relationship. นอกจากนี้ยังใช้เป็นตัวระบุความสัมพันธ์ด้วยIt is also used as the identifier of the relationship. เป็นเท็จFalse เป็นจริงTrue
crossFilteringBehaviorcrossFilteringBehavior สตริงString ทิศทางตัวกรองของความสัมพันธ์: ทางเดียว (ค่าเริ่มต้น), ทั้งสองทาง อัตโนมัติThe filter direction of the relationship: OneDirection (default), BothDirections, Automatic เป็นเท็จFalse เป็นเท็จFalse
fromTablefromTable สตริงString ชื่อของตาราง foreign keyName of the foreign key table. เป็นเท็จFalse เป็นจริงTrue
fromColumnfromColumn สตริงString ชื่อของคอลัมน์ foreign keyName of the foreign key column. เป็นเท็จFalse เป็นจริงTrue
toTabletoTable สตริงString ชื่อของตารางคีย์หลักName of the primary key table. เป็นเท็จFalse เป็นจริงTrue
toColumntoColumn สตริงString ชื่อของคอลัมน์คีย์หลักName of the primary key column. เป็นเท็จFalse เป็นจริงTrue

ข้อจำกัดของชนิดข้อมูลData type restrictions

ข้อจำกัดเหล่านี้นำไปใช้กับคุณสมบัติชนิดข้อมูลThese restrictions apply to dataType property.

ชนิดข้อมูลData type ข้อจำกัดRestrictions
Int64Int64 Int64.MaxValue และ Int64.MinValue ไม่ได้รับอนุญาตInt64.MaxValue and Int64.MinValue not allowed.
สองครั้งDouble Double.MaxValue และค่า Double.MinValue ไม่ได้รับอนุญาตDouble.MaxValue and Double.MinValue values not allowed. NaN ที่ไม่ได้รับการสนับสนุน + ค่าอนันต์และ - ค่าอนันต์ที่ไม่ได้รับการสนับสนุนในบางฟังก์ชัน (เช่น Min, Max)NaN not supported.+Infinity and -Infinity not supported in some functions (e.g. Min, Max).
บูลีนBoolean เป็นจริง หรือ เป็นเท็จTrue or False.
วันที่เวลาDatetime ในระหว่างการโหลดข้อมูล เราแบ่งนับค่าด้วยเศษส่วนวันให้กับตัวคูณทั้งหมดของ 1/300 วินาที (3.33ms)During data loading we quantize values with day fractions to whole multiples of 1/300 seconds (3.33ms).
สตริงString ในขณะนี้ อนุญาตให้สูงสุด 4000 ตัวอักขระสำหรับแต่ละค่าสตริงCurrently allows up to 4000 characters per string value.
ทศนิยมDecimal ความแม่นยำ = 28 สเกล = 4precision=28, scale=4

ตัวอย่างExample

ตัวอย่างโค้ดต่อไปนี้รวมถึงคุณสมบัติเหล่านี้:The following code sample includes a number of these properties:

{

  "name": "PushAdvanced",

  "tables": [

    {

      "name": "Date",

      "columns": [

        {

          "name": "Date",

          "dataType": "dateTime",

          "formatString": "dddd\\, mmmm d\\, yyyy",

          "summarizeBy": "none"

        }

      ]

    },

    {

      "name": "sales",

      "columns": [

        {

          "name": "Date",

          "dataType": "dateTime",

          "formatString": "dddd\\, mmmm d\\, yyyy",

          "summarizeBy": "none"

        },

        {

          "name": "Sales",

          "dataType": "int64",

          "formatString": "0",

          "summarizeBy": "sum"

        }

      ],

      "measures": [

        {

          "name": "percent to forecast",

          "expression": "SUM(sales[Sales])/SUM(forecast[forecast])",

          "formatString": "0.00 %;-0.00 %;0.00 %"

        }

      ]

    },

    {

      "name": "forecast",

      "columns": [

        {

          "name": "date",

          "dataType": "dateTime",

          "formatString": "m/d/yyyy",

          "summarizeBy": "none"

        },

        {

          "name": "forecast",

          "dataType": "int64",

          "formatString": "0",

          "summarizeBy": "sum"

        }

      ]

    }

  ],

  "relationships": [

    {

      "name": "2ea345ce-b147-436e-8ac2-9d3c4d82af8d",

      "fromTable": "sales",

      "fromColumn": "Date",

      "toTable": "Date",

      "toColumn": "Date",

      "crossFilteringBehavior": "bothDirections"

    },

    {

      "name": "5d95f419-e589-4345-9581-6e70670b1bba",

      "fromTable": "forecast",

      "fromColumn": "date",

      "toTable": "Date",

      "toColumn": "Date",

      "crossFilteringBehavior": "bothDirections"

    }

  ]

}