CREATETABLE–SQLCommand

CREATE TABLE – SQL Command

Creates a table having the specified fields.wwww.iTbulo.comem8Zf

CREATE TABLE | DBF TableName1 [NAME LongTableName] [FREE]   

(FieldName1 FieldType [(nFieldWidth [, nPrecision])]      

[NULL | NOT NULL]       [CHECK lExpression1 [ERROR cMessageText1]]      

[DEFAULT eExpression1]      [PRIMARY KEY | UNIQUE]      

[REFERENCES TableName2 [TAG TagName1]]      [NOCPTRANS]   

[, FieldName2 ...]      [, PRIMARY KEY eExpression2 TAG TagName2      

|, UNIQUE eExpression3 TAG TagName3]      

[, FOREIGN KEY eExpression4 TAG TagName4 [NODUP]         REFERENCES TableName3 [TAG TagName5]]      

[, CHECK lExpression2 [ERROR cMessageText2]])| FROM ARRAY ArrayName

Parameters

TableName1

Specifies the name of the table to create. The TABLE and DBF options are identical.

NAME LongTableName

Specifies a long name for the table. A long table name can be specified only when a database is open because long table names are stored in databases.

Long names can contain up to 128 characters and can be used in place of short file names in the database. wwww.iTbulo.comem8Zf

FREE

Specifies that the table will not be added to an open database. FREE isn't required if a database isn't open.

(FieldName1 FieldType [(nFieldWidth [, nPrecision])]

Specifies the field name, field type, field width, and field precision (number of decimal places), respectively.

A single table can contain up to 255 fields. If one or more fields allow null values, the limit is reduced by one to 254 fields.

FieldType is a single letter indicating the field's data type. Some field data types require that you specify nFieldWidth or nPrecision, or both.

The following table lists the values for FieldType and whether nFieldWidth and nPrecision are required. wwww.iTbulo.comem8Zf

FieldType nFieldWidth nPrecision Description C n – Character field of width n D – – Date T – – DateTime N n d Numeric field of width n with d decimal places F n d Floating numeric field of width n with d decimal places I – – Integer B – d Double Y – – Currency L – – Logical M – – Memo G – – General

nFieldWidth and nPrecision are ignored for D, T, I, Y, L, M, G, and P types. nPrecision defaults to zero (no decimal places) if nPrecision isn't included for the N or F types. nPrecision defaults to the number of decimal places specified by the SET DECIMAL setting if nPrecision isn't included for the B type. wwww.iTbulo.comem8Zf

NULL

Allows null values in the field. If one or more fields can contain null values, the maximum number of fields the table can contain is reduced by one, from 255 to 254.

NOT NULL

Prevents null values in the field.

If you omit NULL and NOT NULL, the current setting of SET NULL determines if null values are allowed in the field. However, if you omit NULL and NOT NULL and include the PRIMARY KEY or UNIQUE clause, the current setting of SET NULL is ignored and the field defaults to NOT NULL. wwww.iTbulo.comem8Zf

CHECK lExpression1

Specifies a validation rule for the field. lExpression1 can be a user-defined function. Note that when a blank record is appended, the validation rule is checked. An error is generated if the validation rule doesn't allow for a blank field value in an appended record.

ERROR cMessageText1

Specifies the error message Visual FoxPro displays when the validation rule specified with CHECK generates an error. The message is displayed only when data is changed within a Browse window or Edit window.

DEFAULT eExpression1

Specifies a default value for the field. The data type of eExpression1must be the same as the field's data type.

PRIMARY KEY

Creates a primary index for the field. The primary index tag has the same name as the field.

UNIQUE

Creates a candidate index for the field. The candidate index tag has the same name as the field. For more information about candidate indexes, see Setting a Primary or Candidate Index.

Note   Candidate indexes (created by including the UNIQUE option in CREATE TABLE or ALTER TABLE – SQL) are not the same as indexes created with the UNIQUE option in the INDEX command. An index created with the UNIQUE option in the INDEX command allows duplicate index keys; candidate indexes do not allow duplicate index keys. See INDEX for additional information on its UNIQUE option.

Null values and duplicate records are not permitted in a field used for a primary or candidate index. However, Visual FoxPro will not generate an error if you create a primary or candidate index for a field that supports null values. Visual FoxPro will generate an error if you attempt to enter a null or duplicate value into a field used for a primary or candidate index. wwww.iTbulo.comem8Zf

REFERENCES TableName2 [TAG TagName1]

Specifies the parent table to which a persistent relationship is established. If you omit TAG TagName1, the relationship is established using the primary index key of the parent table. If the parent table does not have a primary index, Visual FoxPro generates an error.

Include TAG TagName1 to establish a relation based on an existing index tag for the parent table. Index tag names can contain up to 10 characters.

The parent table cannot be a free table. wwww.iTbulo.comem8Zf

NOCPTRANS

Prevents translation to a different code page for character and memo fields. If the table is converted to another code page, the fields for which NOCPTRANS has been specified are not translated. NOCPTRANS can only be specified for character and memo fields. This will create what appears in the Table Designer as Character (binary) and Memo (binary) data types.

The following example creates a table named MYTABLE containing two character fields and two memo fields. The second character field CHAR2 and the second memo field MEMO2 include NOCPTRANS to prevent translation.

CREATE TABLE mytable (char1 C(10), char2 C(10) NOCPTRANS,;

   memo1 M, memo2 M NOCPTRANS)

PRIMARY KEY eExpression2 TAG TagName2

Specifies a primary index to create. eExpression2 specifies any field or combination of fields in the table. TAG TagName2 specifies the name for the primary index tag that is created. Index tag names can contain up to 10 characters.

Because a table can have only one primary index, you cannot include this clause if you have already created a primary index for a field. Visual FoxPro generates an error if you include more than one PRIMARY KEY clause in CREATE TABLE. wwww.iTbulo.comem8Zf

UNIQUE eExpression3 TAG TagName3