Creates a new database.
create [temporary] database database_name [on {default | database_device} [= size] [, database_device [= size]]...] [log on database_device [= size] [, database_device [= size]]...] [with {override | default_location = "pathname"}] [for {load | proxy_update}]
indicates that you are creating a temporary database.
is the name of the new database. It must conform to the rules for identifiers and cannot be a variable.
indicates a location and size for the database.
indicates that create database can put the new database on any default database devices, as shown in sysdevices.status. To specify a size for the database without specifying a location, use:
on default = size
To change a database device’s status to “default,” use sp_diskdefault.
is the logical name of the device on which to locate the database. A database can occupy different amounts of space on each of several database devices. To add database devices to Adaptive Server, use disk init.
is the amount of space to allocate to the database extension. You can use the following unit specifiers, using uppercase, lowecase, single and double quotes interchangeably: ‘k’ or “K” (kilobytes), “m” or ‘M’ (megabytes), “g” or “G” (gigabytes), and ‘t’ or ‘T’ (terabytes). Sybase recommends that you always include a unit specifier. Quotes are optional if you do not include a unit specifier. However, you must use quotes if you include a unit specifier. If you do not provide a unit specifier, the value provided is presumed to be in megabytes.
specifies the logical name of the device for the database logs. You can specify more than one device in the log on clause.
forces Adaptive Server to accept your device specifications, even if they mix data and transaction logs on the same device, thereby endangering up-to-the-minute recoverability for your database. If you attempt to mix log and data on the same device without using this clause, the create database command fails. If you mix log and data, and use with override, you are warned, but the command succeeds.
invokes a streamlined version of create database that you can use only for loading a database dump. See “Using the for load option” for more information.
specifies the storage location of new tables. If you also specify the for proxy_update clause, one proxy table for each remote table or view is automatically created from the specified location.
automatically gets metadata from the remote location and creates proxy tables. You cannot use for proxy_update unless you also specify with default_location.
Creates a database named pubs:
create database pubs
Creates a 4MB database named pubs:
create database pubs on default = 4
If you do not provide a unit specifier for size, the value provided for pubs is presumed to be in megabytes.
Creates a database named pubs with 3MB on the datadev device and 2MB on the moredatadev device:
create database pubs on datadev = "3M", moredatadev = '2.0m'
Creates a database named pubs with 3MB of data on the datadev device and a 0.5GB log on the logdev device:
create database pubs on datadev='3m' log on logdev='0.5g'
Creates a proxy database named proxydb but does not automatically create proxy tables:
create database proxydb with default_location "UNITEST.pubs.dbo."
Creates a proxy database named proxydb and automatically creates proxy tables:
create database proxydb on default = "4M" with default_location "UNITEST.pubs2.dbo." for proxy_update
Creates a proxy database named proxydb, and retrieves the metadata for all of the remote tables from a remote database:
create database proxydb on default = 4 with default_location "UNITEST.pubs2.." for proxy_update
Creates a temporary database called mytempdb1, with 3MB of data on the datadev device and 1MB of log on the logdev device:
create temporary database mytempdb1 on datadev = '3m' log on logdev = '1M'
Creates a table with one materialized computed column:
create table mytitles (title_id tid not null, title varchar(80) not null, type char(12) not null, pub_id char(4) null, price money null, advance money null, total_sales int null, notes varchar(200) null, pubdate datetime not null, sum_sales compute price * total_sales materialized)
Use create database from the master database.
You can specify the size as a float datatype, however, the size is rounded down to the nearest multiple of the allocation unit.
If you do not explicitly state the size of the database, the size is determined by the size of the model database. The minimum size that you can create a database is four allocation units.
Because Adaptive Server allocates space for databases for create database and alter database in chunks of 256 logical pages, these commands round the specified size down to the nearest multiple of allocation units.
If you do not include a unit specifier, Adaptive Server interprets the size in terms of megabytes of disk space, and this number is converted to the logical page size the server uses.
If you do not specify a location and size for a database, the default location is any default database devices indicated in master..sysdevices. The default size is the larger of the size of the model database or the default database size parameter in sysconfigures.
System Administrators can increase the default size by using sp_configure to change the value of default database size and restarting Adaptive Server. The default database size parameter must be at least as large as the model database. If you increase the size of the model database, you must also increase the default size.
If Adaptive Server cannot give you as much space as you want where you have requested it, it comes as close as possible, on a per-device basis, and prints a message telling how much space was allocated and where it was allocated. The maximum size of a database is system-dependent.
If you create a proxy database using:
create database mydb on my_device with default_location = "pathname" for proxy_update
The presence of the device name is enough to bypass size calculation, and this command may fail if the default database size (the size of the model database) is not large enough to contain all of the proxy tables.
To allow CIS to estimate database size, do not include any device name or other option with this command:
create database mydb with default_location = "pathname" for proxy_update
Adaptive Server can manage as many as 32,767 databases.
Adaptive Server can create only one database at a time. If two database creation requests collide, one user sees this message:
model database in use: cannot create new database
Each time you allocate space on a database device with create database or alter database, that allocation represents a device fragment, and the allocation is entered as a row in sysusages.
The maximum number of named segments for a database is 32. Segments are named subsets of database devices available to a particular Adaptive Server. For more information on segments, see the System Administration Guide.
You cannot use either with default_location or for proxy_update parameters with the create temporary database command, and doing so generates an error, such as the following two examples:
1> create temporary database tb1 with default_location "remSERVER.mydb.."
Msg 102, Level 15, State 7: Server 'ebi_SUS_AS125x_SUN32', Line 1: Incorrect syntax near 'create temporary database'.
1> create temporary database tb1 with default_location "remSERVER.mydb.." for proxy_update
Msg 102, Level 15, State 7: Server 'ebi_SUS_AS125x_SUN32', Line 1: Incorrect syntax near 'create temporary database'.
The temporary status of a database, which is set during the creation of the temporary database, is indicated by value 0x00000100 (256 decimal) of the status3 field of a sysdatabases entry.
In addition to all options inherited from model, a temporary database, like the system tempdb, has the following database options set:
select into/bulkcopy
trunc log on chkpt
As with system tempdb, the guest user is added to the temporary database, and create table permission is granted to PUBLIC.
Unused pages are not cleared during creation of the temporary database, since a temporary database is re-created every time the server is restarted.
Adaptive Server creates a new database by copying the model database.
You can customize model by adding tables, stored procedures, user-defined datatypes, and other objects, and by changing database option settings. New databases inherit these objects and settings from model.
To guarantee recoverability, create database must clear every page that was not initialized when the model database was copied. This may take several minutes, depending on the size of the database and the speed of your system.
If you are creating a database to load a database dump into it, you can use the for load option to skip the page-clearing step. This makes database creation considerably faster.
Back up the master database each time you create a new database. This makes recovery easier and safer if master is damaged.
If you create a database and fail to back up master, you may be able to recover the changes with disk reinit.
The with override clause allows you to mix log and data segments on a single device. However, for full recoverability, the device or devices specified in log on should be different from the physical device that stores the data. In the event of a hard disk crash, you can recover the database from database dumps and transaction logs.
You can create a small database on a single device that is used to store both the transaction log and the data, but you must rely on the dump database command for backups.
The size of the device required for the transaction log varies according to the amount of update activity and the frequency of transaction log dumps. As a rule of thumb, allocate to the log device 10 – 25 percent of the space you allocate to the database itself. It is best to start small, since space allocated to a transaction log device cannot be reclaimed and cannot be used for storing data.
You can use the for load option for recovering from media failure or for moving a database from one machine to another, if you have not added to the database with sp_addsegment. Use alter database for load to create a new database in the image of the database from which the database dump to be loaded was made. For a discussion of duplicating space allocation when loading a dump into a new database, see the System Administration Guide.
When you create a database using the for load option, you can run only the following commands in the new database before loading a database dump:
alter database for load
After you load the database dump into the new database, you can also use some dbcc diagnostic commands in the databases. After you issue the online database command, there are no restrictions on the commands you can use.
A database created with the for load option has a status of “don’t recover” in the output from sp_helpdb.
To get a report on a database, execute sp_helpdb.
For a report on the space used in a database, use sp_spaceused.
Without the for proxy_update clause, the behavior of the with default_location clause is the same as that provided by sp_defaultloc—a default storage location is established for new and existing table creation, but automatic import of proxy table definitions is not done during the processing of create database.
If for proxy_update is specified with no default_location, an error is reported.
When a proxy database is created (using the for proxy_update option), Component Integration Services is called upon to:
Provide an estimate of the database size required to contain all proxy tables representing the actual tables and views found in the primary server’s database. This estimate is the number of database pages needed to contain all proxy tables and indexes. The estimate is used if no size is specified, and no database devices are specified.
Create all proxy tables representing the actual tables and views found in the companion server’s database.
Grant all permissions on proxy tables to public.
Add the guest user to the proxy database.
The database status is set to indicate that this database ‘Is_A_Proxy’. This status is contained in master.dbo.sysdatabases.status3.
ANSI SQL – Compliance level: Transact-SQL extension.
create database permission defaults to System Administrators, who can transfer it to users listed in the sysusers table of the master database. However, create database permission is often centralized to maintain control over database storage allocation.
If you are creating the sybsecurity database, you must be a System Security Officer.
create database permission is not included in the grant all command.
Values in event and extrainfo columns of sysaudits are:
Event |
Audit option |
Command or access audited |
Information in extrainfo |
---|---|---|---|
9 |
create |
create database |
|
Commands alter database, disk init, drop database, dump database, load database, online database
System procedures sp_changedbowner, sp_diskdefault, sp_helpdb, sp_logdevice, sp_renamedb, sp_spaceused
Copyright © 2005. Sybase Inc. All rights reserved. |