Ιδιότητες συνόλου δεδομένωνDataset properties

  • 3 λεπτά για ανάγνωση

Η τρέχουσα έκδοση 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
αναγνωριστικόid GuidGuid Μοναδικό αναγνωριστικό σε ολόκληρο το σύστημα για το σύνολο δεδομένων.System wide unique identifier for the dataset. ΑληθέςTrue FalseFalse
namename ΣυμβολοσειράString Το όνομα του συνόλου δεδομένων που καθορίζεται από τον χρήστη.User defined name of the dataset. FalseFalse ΑληθέςTrue
tablestables Table[]Table[] Μια συλλογή πινάκων.Collection of tables. FalseFalse FalseFalse
relationshipsrelationships Relationship[]Relationship[] Μια συλλογή σχέσεων μεταξύ πινάκων.Collection of relationships between tables. FalseFalse FalseFalse
defaultModedefaultMode ΣυμβολοσειράString Καθορίζει εάν πραγματοποιείται προώθηση, ροή ή και τα δύο για το σύνολο δεδομένων, με τιμές "Push" και "Streaming".Determines whether the dataset is pushed, streamed, or both, with values of "Push" and "Streaming." FalseFalse FalseFalse

ΠίνακαςTable

ΌνομαName ΤύποςType ΠεριγραφήDescription Μόνο για ανάγνωσηRead Only ΑπαιτείταιRequired
namename ΣυμβολοσειράString Το όνομα του πίνακα που καθορίζεται από τον χρήστη.User defined name of the table. Χρησιμοποιείται επίσης ως αναγνωριστικό του πίνακα.It is also used as the identifier of the table. FalseFalse ΑληθέςTrue
columnscolumns column[]column[] Μια συλλογή στηλών.Collection of columns. FalseFalse ΑληθέςTrue
measuresmeasures measure[]measure[] Μια συλλογή μετρήσεων.Collection of measures. FalseFalse FalseFalse
isHiddenisHidden Δυαδική τιμήBoolean Αν η τιμή είναι true, ο πίνακας δεν θα είναι ορατός στα εργαλεία προγράμματος-πελάτη.If true, table will be hidden from client tools. FalseFalse FalseFalse

ΣτήληColumn

ΌνομαName ΤύποςType ΠεριγραφήDescription Μόνο για ανάγνωσηRead Only ΑπαιτείταιRequired
namename ΣυμβολοσειράString Το όνομα της στήλης που καθορίζεται από τον χρήστη.User defined name of the column. FalseFalse ΑληθέςTrue
dataTypedataType ΣυμβολοσειράString Υποστηριζόμενοι τύποι δεδομένων EDM και περιορισμοί.Supported EDM data types and restrictions. Ανατρέξτε στο θέμα Περιορισμοί τύπων δεδομένων.See Data type restrictions. FalseFalse ΑληθέςTrue
formatStringformatString ΣυμβολοσειράString Μια συμβολοσειρά που περιγράφει τον τρόπο με τον οποίο μια τιμή πρέπει να μορφοποιείται όταν εμφανίζεται.A string describing how the value should be formatted when it is displayed. Για να μάθετε περισσότερα σχετικά με τη μορφοποίηση συμβολοσειρών, ανατρέξτε στο θέμα Περιεχόμενα FORMAT_STRING.To learn more about string formatting, see FORMAT_STRING Contents. FalseFalse FalseFalse
sortByColumnsortByColumn ΣυμβολοσειράString Το όνομα συμβολοσειράς μιας στήλης στον ίδιο πίνακα που θα χρησιμοποιηθεί για ταξινόμηση της τρέχουσας στήλης.String name of a column in the same table to be used to order the current column. FalseFalse FalseFalse
dataCategorydataCategory ΣυμβολοσειράString Η τιμή συμβολοσειράς που θα χρησιμοποιηθεί για την κατηγορία δεδομένων που περιγράφει τα δεδομένα σε αυτήν τη στήλη.String value to be used for the data category which describes the data within this column. Ορισμένες κοινές τιμές είναι: Address, City, Continent, Country, Image, ImageUrl, Latitude, Longitude, Organization, Place, PostalCode, StateOrProvince, WebUrlSome common values include: Address, City, Continent, Country, Image, ImageUrl, Latitude, Longitude, Organization, Place, PostalCode, StateOrProvince, WebUrl FalseFalse FalseFalse
isHiddenisHidden Δυαδική τιμήBoolean Μια ιδιότητα που υποδεικνύει αν γίνεται απόκρυψη της στήλης.Property indicating if the column is hidden from view. Η προεπιλεγμένη τιμή είναι false.Default is false. FalseFalse FalseFalse
summarizeBysummarizeBy ΣυμβολοσειράString Η προεπιλεγμένη μέθοδος συνάθροισης για τη στήλη.Default aggregation method for the column. Οι τιμές είναι: default, none, sum, min, max, count, average, distinctCountValues include: default, none, sum, min, max, count, average, distinctCount FalseFalse FalseFalse

ΜέτρησηMeasure

ΌνομαName ΤύποςType ΠεριγραφήDescription Μόνο για ανάγνωσηRead Only ΑπαιτείταιRequired
namename ΣυμβολοσειράString Το όνομα της μέτρησης που καθορίζεται από τον χρήστη.User defined name of the measure. FalseFalse ΑληθέςTrue
expressionexpression ΣυμβολοσειράString Μια έγκυρη παράσταση DAX.A valid DAX expression. FalseFalse ΑληθέςTrue
formatStringformatString ΣυμβολοσειράString Μια συμβολοσειρά που περιγράφει τον τρόπο με τον οποίο μια τιμή πρέπει να μορφοποιείται όταν εμφανίζεται.A string describing how the value should be formatted when it is displayed. Για να μάθετε περισσότερα σχετικά με τη μορφοποίηση συμβολοσειρών, ανατρέξτε στο θέμα Περιεχόμενα FORMAT_STRING.To learn more about string formatting, see FORMAT_STRING Contents. FalseFalse FalseFalse
isHiddenisHidden ΣυμβολοσειράString Αν η τιμή είναι true, ο πίνακας δεν θα είναι ορατός στα εργαλεία προγράμματος-πελάτη.If true, table will be hidden from client tools. FalseFalse FalseFalse

Σχέση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. FalseFalse ΑληθέςTrue
crossFilteringBehaviorcrossFilteringBehavior ΣυμβολοσειράString Η κατεύθυνση φίλτρου της σχέσης: OneDirection (προεπιλογή), BothDirections, AutomaticThe filter direction of the relationship: OneDirection (default), BothDirections, Automatic FalseFalse FalseFalse
fromTablefromTable ΣυμβολοσειράString Το όνομα του πίνακα εξωτερικού κλειδιού.Name of the foreign key table. FalseFalse ΑληθέςTrue
fromColumnfromColumn ΣυμβολοσειράString Το όνομα της στήλης εξωτερικού κλειδιού.Name of the foreign key column. FalseFalse ΑληθέςTrue
toTabletoTable ΣυμβολοσειράString Το όνομα του πίνακα πρωτεύοντος κλειδιού.Name of the primary key table. FalseFalse ΑληθέςTrue
toColumntoColumn ΣυμβολοσειράString Το όνομα της στήλης πρωτεύοντος κλειδιού.Name of the primary key column. FalseFalse ΑληθέςTrue

Περιορισμοί τύπων δεδομένωνData type restrictions

Αυτοί οι περιορισμοί ισχύουν για την ιδιότητα dataType.These restrictions apply to dataType property.

Τύπος δεδομένωνData type ΠεριορισμοίRestrictions
Int64Int64 Δεν επιτρέπονται τα Int64.MaxValue και Int64.MinValue.Int64.MaxValue and Int64.MinValue not allowed.
DoubleDouble Δεν επιτρέπονται τα Double.MaxValue και Double.MinValue.Double.MaxValue and Double.MinValue values not allowed. Δεν υποστηρίζεται το NaN. Δεν υποστηρίζονται τα +Infinity και -Infinity σε ορισμένες λειτουργίες (π.χ. Min, Max).NaN not supported.+Infinity and -Infinity not supported in some functions (e.g. Min, Max).
Δυαδική τιμήBoolean True ή False.True or False.
DatetimeDatetime Κατά τη φόρτωση δεδομένων κβαντοποιούμε με κλάσματα ημέρας σε ολόκληρα πολλαπλάσια του 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.
DecimalDecimal ακρίβεια=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"

    }

  ]

}